Operation

GET /advertisers/{id}/contacts

Returns the same contact list shown on the advertiser page team tab. LinkedIn profile URLs are included in the contact attributes when present.

Operation ID: listAdvertiserContacts · Tags: Advertisers

Parameters

Name In Required Type Description
id path Yes string Advertiser ID or slug
show_unverified query No boolean When true, include contacts with status unverified (maps to ContactSearchService include_unverified; rating ≥ 1 still applies)
limit query No integer Page size (alias of per_page; default 30)
per_page query No integer Page size (alias of limit; default 30)
page query No integer Page number

Request Body

No request body is defined for this operation.

Responses

Content Types

  • application/json
{
  "description": "Advertiser contacts",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Contact"
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "advertiser": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  },
                  "slug": {
                    "type": "string"
                  },
                  "domain": {
                    "type": "string",
                    "nullable": true
                  },
                  "display_name": {
                    "type": "string",
                    "nullable": true
                  }
                }
              },
              "count": {
                "type": "integer"
              },
              "show_unverified": {
                "type": "boolean"
              },
              "source": {
                "type": "string"
              }
            }
          }
        },
        "required": [
          "data",
          "meta"
        ]
      }
    }
  }
}

{
  "$ref": "#/components/responses/Unauthorized"
}

{
  "$ref": "#/components/responses/Forbidden"
}

{
  "$ref": "#/components/responses/NotFound"
}

API Playground

Run this GET request with your API key, or open it in a new tab. Path uses sample IDs where the OpenAPI path has {parameters}. Sign in to enable live testing with your API key.

Action Method Endpoint Description
List advertiser contacts GET /api/v1/advertisers/6383/contacts OpenAPI operationId: listAdvertiserContacts.
GET /api/v1/advertisers/6383/contacts OpenAPI

List advertiser contacts


    
Ask Dex AIIntegration help

If this page feels TLDR, ask Dex AI.

Dex AI speaks your language, and all the other languages you may not. It will write the integration for you with the right endpoint and headers in one plain-English answer.