Advertisers

Advertiser accounts managed by this agency.

List all advertisers

get

Returns a list of all advertisers associated with your agency account.

Each result includes full account details — contact information, billing setup, organization details, and a pre-authenticated RestAccountURL for making direct API calls to each advertiser's account.

Path parameters

AccountSIDstringRequired

Your Agency Account SID.

Example: IRq8mWJybvoQ1020978kbj7am8zzM2dBL1

Responses

200

A list of advertisers.

application/json

An advertiser account managed through your agency.

IdstringOptional

The unique numeric identifier for the advertiser account.

Example: 1048291

NamestringOptional

The advertiser's business or brand name as registered on impact.com.

Example: Nutt & Co. Outdoors

DescriptionstringOptional

A free-text description of the advertiser. May be an empty string if none has been set.

Example: Premium outdoor gear and adventure accessories.

Statestring · enumOptional

The current status of the advertiser account.

Value	Description
ACTIVE	Account is active and in good standing.
DELINQUENT	Account has overdue payments or billing issues.

Example: ACTIVEPossible values:

WebsitestringOptional

The advertiser's primary website URL.

Example: www.nuttandco.com

AddressLine1stringOptional

First line of the advertiser's registered business address.

Example: 100 Commerce Drive

AddressLine2stringOptional

Second line of the address (suite, floor, unit, etc.). May be an empty string if not provided.

Example: Suite 200

CitystringOptional

City of the advertiser's registered business address.

Example: Austin

CountryStatestringOptional

State, province, or region associated with the advertiser's address. May return OTHER for non-standard jurisdictions, or an empty string if not provided.

Example: TX

PostalCodestringOptional

ZIP or postal code of the advertiser's registered business address.

Example: 78701

CountrystringOptional

Country of the advertiser's registered business address (e.g., US, SOUTHAFRICA).

Example: US

IndirectTaxJurisdictionstringOptional

The tax jurisdiction used to calculate indirect taxes (e.g., GST, VAT) for this advertiser. May be an empty string if indirect taxes do not apply.

VatRegisteredstring · enumOptional

Indicates whether the advertiser is registered for VAT. Returns "true" or "false" as a string value.

Example: falsePossible values:

OrganizationTypestring · enumOptional

The legal organization type of the advertiser.

Value	Description
CORP	Corporation or limited company.
NONP_GOV	Non-profit organization or government entity.
OTHER	Any other organization type.

Example: CORPPossible values:

TaxIdstringOptional

The advertiser's tax identification number. For security, only the last four digits are returned and the rest are masked (e.g., XXXXX4832). Returns an empty string if no tax ID has been provided.

Example: XXXXX4832

IndirectTaxNumberstringOptional

The advertiser's indirect tax registration number (e.g., a GST, HST, or EU VAT number). Returns an empty string if not applicable.

TimezonestringOptional

The advertiser's default timezone in IANA format. Used for scheduling and date-based reporting.

Example: America/Chicago

CurrencystringOptional

The advertiser's billing currency in ISO 4217 format.

Example: USD

PhoneNumberstringOptional

The advertiser's primary contact phone number. Digits only — no spaces, dashes, or other formatting characters.

Example: 15125550191

DateCreatedstring · date-timeOptional

The date and time when the advertiser account was created on impact.com, in ISO 8601 format with UTC offset.

Example: 2021-03-15T09:22:11-07:00

FinancialSetupstring · enumOptional

How the advertiser is billed for impact.com platform fees.

Value	Description
BILLED_BY_IR	The advertiser is billed directly by impact.com.

Example: BILLED_BY_IRPossible values:

AgencyOfRecordstring · enumOptional

Indicates whether the authenticated agency is the designated Agency of Record (AoR) for this advertiser. An Agency of Record has full management authority over the advertiser's account. Returns "true" or "false" as a string value.

Example: truePossible values:

RestAccountURLstringOptional

A pre-authenticated URL for making API calls directly to this advertiser's account. The URL embeds the advertiser's Account SID and Auth Token in the format SID:[e-mail]/Advertisers/SID, using the legacy api.impactradius.com domain.

Security note: Treat this value as a secret. It grants full API access to the advertiser's account. Never log it or expose it in client-side code.

Example: IRxxxxxxxxxxxxxxxxx1:[e-mail]/Advertisers/IRxxxxxxxxxxxxxxxxx1

UristringOptional

The relative URI for this advertiser resource within the Agency API. Append to https://api.impact.com to form the full resource URL.

Example: /Agencies/IRq8mWJybvoQ1020978kbj7am8zzM2dBL1/Advertisers/1048291

AccountManagerstringOptional

The full name of the impact.com account manager assigned to this advertiser. Only present in the response when an account manager has been assigned — the field will be absent if no manager is assigned.

Example: Carrie Oakey

401

Unauthorized. Check that your Account SID and Auth Token are correct.

get/Agencies/{AccountSID}/Advertisers

HTTPcURLJavaScriptPython

GET /Agencies/{AccountSID}/Advertisers HTTP/1.1
Host: api.impact.com
Accept: */*

[
  {
    "Id": "1048291",
    "Name": "Nutt & Co. Outdoors",
    "Description": "Premium outdoor gear and adventure accessories.",
    "State": "ACTIVE",
    "Website": "www.nuttandco.com",
    "AddressLine1": "100 Commerce Drive",
    "AddressLine2": "Suite 200",
    "City": "Austin",
    "CountryState": "TX",
    "PostalCode": "78701",
    "Country": "US",
    "IndirectTaxJurisdiction": "",
    "VatRegistered": "false",
    "OrganizationType": "CORP",
    "TaxId": "XXXXX4832",
    "IndirectTaxNumber": "",
    "Timezone": "America/Chicago",
    "Currency": "USD",
    "PhoneNumber": "15125550191",
    "DateCreated": "2021-03-15T09:22:11-07:00",
    "FinancialSetup": "BILLED_BY_IR",
    "AgencyOfRecord": "true",
    "AccountManager": "Carrie Oakey",
    "RestAccountURL": "IRxxxxxxxxxxxxxxxxx1:[e-mail]/Advertisers/IRxxxxxxxxxxxxxxxxx1",
    "Uri": "/Agencies/IRq8mWJybvoQ1020978kbj7am8zzM2dBL1/Advertisers/1048291"
  }
]

Get an advertiser

get

Returns the full details of a single advertiser account by its numeric ID.

Path parameters

AccountSIDstringRequired

Your Agency Account SID.

Example: IRq8mWJybvoQ1020978kbj7am8zzM2dBL1

AdvertiserIdstringRequired

The numeric ID of the advertiser to retrieve. Use the Id field from the List Advertisers response.

Example: 1048291

Responses

200

The advertiser object.

application/json

An advertiser account managed through your agency.

IdstringOptional

The unique numeric identifier for the advertiser account.

Example: 1048291

NamestringOptional

The advertiser's business or brand name as registered on impact.com.

Example: Nutt & Co. Outdoors

DescriptionstringOptional

A free-text description of the advertiser. May be an empty string if none has been set.

Example: Premium outdoor gear and adventure accessories.

Statestring · enumOptional

The current status of the advertiser account.

Value	Description
ACTIVE	Account is active and in good standing.
DELINQUENT	Account has overdue payments or billing issues.

Example: ACTIVEPossible values:

WebsitestringOptional

The advertiser's primary website URL.

Example: www.nuttandco.com

AddressLine1stringOptional

First line of the advertiser's registered business address.

Example: 100 Commerce Drive

AddressLine2stringOptional

Second line of the address (suite, floor, unit, etc.). May be an empty string if not provided.

Example: Suite 200

CitystringOptional

City of the advertiser's registered business address.

Example: Austin

CountryStatestringOptional

State, province, or region associated with the advertiser's address. May return OTHER for non-standard jurisdictions, or an empty string if not provided.

Example: TX

PostalCodestringOptional

ZIP or postal code of the advertiser's registered business address.

Example: 78701

CountrystringOptional

Country of the advertiser's registered business address (e.g., US, SOUTHAFRICA).

Example: US

IndirectTaxJurisdictionstringOptional

The tax jurisdiction used to calculate indirect taxes (e.g., GST, VAT) for this advertiser. May be an empty string if indirect taxes do not apply.

VatRegisteredstring · enumOptional

Indicates whether the advertiser is registered for VAT. Returns "true" or "false" as a string value.

Example: falsePossible values:

OrganizationTypestring · enumOptional

The legal organization type of the advertiser.

Value	Description
CORP	Corporation or limited company.
NONP_GOV	Non-profit organization or government entity.
OTHER	Any other organization type.

Example: CORPPossible values:

TaxIdstringOptional

The advertiser's tax identification number. For security, only the last four digits are returned and the rest are masked (e.g., XXXXX4832). Returns an empty string if no tax ID has been provided.

Example: XXXXX4832

IndirectTaxNumberstringOptional

The advertiser's indirect tax registration number (e.g., a GST, HST, or EU VAT number). Returns an empty string if not applicable.

TimezonestringOptional

The advertiser's default timezone in IANA format. Used for scheduling and date-based reporting.

Example: America/Chicago

CurrencystringOptional

The advertiser's billing currency in ISO 4217 format.

Example: USD

PhoneNumberstringOptional

The advertiser's primary contact phone number. Digits only — no spaces, dashes, or other formatting characters.

Example: 15125550191

DateCreatedstring · date-timeOptional

The date and time when the advertiser account was created on impact.com, in ISO 8601 format with UTC offset.

Example: 2021-03-15T09:22:11-07:00

FinancialSetupstring · enumOptional

How the advertiser is billed for impact.com platform fees.

Value	Description
BILLED_BY_IR	The advertiser is billed directly by impact.com.

Example: BILLED_BY_IRPossible values:

AgencyOfRecordstring · enumOptional

Indicates whether the authenticated agency is the designated Agency of Record (AoR) for this advertiser. An Agency of Record has full management authority over the advertiser's account. Returns "true" or "false" as a string value.

Example: truePossible values:

RestAccountURLstringOptional

A pre-authenticated URL for making API calls directly to this advertiser's account. The URL embeds the advertiser's Account SID and Auth Token in the format SID:[e-mail]/Advertisers/SID, using the legacy api.impactradius.com domain.

Security note: Treat this value as a secret. It grants full API access to the advertiser's account. Never log it or expose it in client-side code.

Example: IRxxxxxxxxxxxxxxxxx1:[e-mail]/Advertisers/IRxxxxxxxxxxxxxxxxx1

UristringOptional

The relative URI for this advertiser resource within the Agency API. Append to https://api.impact.com to form the full resource URL.

Example: /Agencies/IRq8mWJybvoQ1020978kbj7am8zzM2dBL1/Advertisers/1048291

AccountManagerstringOptional

The full name of the impact.com account manager assigned to this advertiser. Only present in the response when an account manager has been assigned — the field will be absent if no manager is assigned.

Example: Carrie Oakey

401

Unauthorized. Check that your Account SID and Auth Token are correct.

404

Advertiser not found. Verify that the AdvertiserId belongs to an advertiser managed by this agency.

get/Agencies/{AccountSID}/Advertisers/{AdvertiserId}

HTTPcURLJavaScriptPython

GET /Agencies/{AccountSID}/Advertisers/{AdvertiserId} HTTP/1.1
Host: api.impact.com
Accept: */*

{
  "Id": "1048291",
  "Name": "Nutt & Co. Outdoors",
  "Description": "Premium outdoor gear and adventure accessories.",
  "State": "ACTIVE",
  "Website": "www.nuttandco.com",
  "AddressLine1": "100 Commerce Drive",
  "AddressLine2": "Suite 200",
  "City": "Austin",
  "CountryState": "TX",
  "PostalCode": "78701",
  "Country": "US",
  "IndirectTaxJurisdiction": "",
  "VatRegistered": "false",
  "OrganizationType": "CORP",
  "TaxId": "XXXXX4832",
  "IndirectTaxNumber": "",
  "Timezone": "America/Chicago",
  "Currency": "USD",
  "PhoneNumber": "15125550191",
  "DateCreated": "2021-03-15T09:22:11-07:00",
  "FinancialSetup": "BILLED_BY_IR",
  "AgencyOfRecord": "true",
  "AccountManager": "Carrie Oakey",
  "RestAccountURL": "IRxxxxxxxxxxxxxxxxx1:[e-mail]/Advertisers/IRxxxxxxxxxxxxxxxxx1",
  "Uri": "/Agencies/IRq8mWJybvoQ1020978kbj7am8zzM2dBL1/Advertisers/1048291"
}