List Ad Sources

GET

https://platform-api.convirza.com/v3/ad-source

Miscellaneous

Last modified:2026-04-03 14:27:57

Returns the complete list of active advertising sources (marketing channels) available for assignment to tracking numbers and campaigns.

What ad sources are used for
Ad sources identify where a caller originated — for example: Google Ads, Facebook, Direct Mail, or Organic Search. When a call comes in on a tracking number tagged with a specific ad source, the call record is attributed to that channel. This powers call attribution and ROI reporting across your marketing channels.

Response
Each record includes:

ad_source_id and ad_source_name — the unique identifier and display label.

category — the top-level channel group (e.g. Digital, Print, Direct).

sub_category — the specific sub-channel (e.g. Paid Search, Social Media, Email).

The list is platform-wide and does not vary by account. No filters are available — the full active set is always returned.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200

application/json

Successfully retrieved ad sources list

Body

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://platform-api.convirza.com/v3/ad-source' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "code": 200,
    "message": "Success",
    "data": {
        "ad_sources": [
            {
                "channel_id": 56,
                "category": "API",
                "sub_category": "Call Upload"
            },
            {
                "channel_id": 25,
                "category": "Bing",
                "sub_category": "Display"
            },
            {
                "channel_id": 19,
                "category": "Google",
                "sub_category": "Paid"
            }
        ]
    },
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-01-20T12:34:56.789Z"
}

Modified at 2026-04-03 14:27:57

Get SMS Conversations

List Industries