Get Marketing Attribution Data

Returns individual calls with DNI (Dynamic Number Insertion) attribution data.

PREREQUISITES:

DNI tracking must be configured through the Convirza portal first.

Integration setup is NOT available via API (portal access required).

Only returns calls with DNI session data (calls without DNI tracking are excluded).

This endpoint retrieves individual call records with complete DNI attribution information including:

UTM parameters (source, medium, campaign, content, term)

Google Click ID (gclid) and Google Analytics Client ID

Referring URL and campaign information

Call transcription and AI-generated summary

Call recording URL (if available)

Query parameters:

limit: Maximum number of calls to return (default: 100, max: 1000).

offset: Number of calls to skip for pagination (default: 0).

sort_by: Field to sort by (source_name, total_calls, conversion_rate, roi, cost_per_conversion).

sort_order: Sort direction (asc, desc) - default: desc.

Response:

Array of calls with complete DNI attribution data.

Each call includes insight_name (campaign/source name), call details, dni_data object, and transcription.

Total count for pagination.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

{ "code": 200, "message": "Success", "data": { "calls": [ { "insight_name": "Spring Sale 2026", "call_id": 12345, "caller_id": "+15551234567", "tracking_number": "+15559876543", "call_started": "2026-04-01T10:30:00.000Z", "duration": 125, "disposition": "ANSWERED", "org_unit_id": 123, "org_unit_name": "Sales Team", "recording_url": "https://example.com/recording.mp3", "dni_data": { "utm_source": "google", "utm_medium": "cpc", "utm_campaign": "spring-sale-2026", "utm_content": "roofing-keywords", "utm_term": "roofing", "gclid": "Cj0KCQiA_abc123...", "gclsrc": "aw.ds", "google_analytics_cid": "1234567890.0987654321", "referring_url": "https://google.com/search?q=roofing", "campaign_name": "Spring Sale 2026", "campaign_id": "3962" }, "summary": "Customer asked about financing.", "transcription": "Caller: I need a roof inspection...", "transcription_details": [ { "channel": "Customer", "time": "00:12", "text": "Hello, I need help with my account" } ] } ], "total": 150, "limit": 100, "offset": 0 }, "request_id": "550e8400-e29b-41d4-a716-446655440000", "timestamp": "2026-01-20T12:34:56.789Z" }

Get Marketing Attribution Data

Request

Responses