Phone Numbers

List All Phone Numbers

get

Returns a list of all phone numbers available to your account, with optional filtering.

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

AccountSIDstringRequired

Your unique Account SID.

Query parameters

IdstringOptional

A comma-separated list of specific Phone Number IDs to retrieve.

LastDateAssignedstring · date-timeOptional

Filter for numbers last assigned on a specific date (ISO 8601).

LastDateReleasedstring · date-timeOptional

Filter for numbers last released on a specific date (ISO 8601).

NumberstringOptional

A comma-separated list of specific phone numbers to retrieve.

Responses

200

A list of phone number objects.

application/json

get/Advertisers/{AccountSID}/PhoneNumbers

HTTPcURLJavaScriptPython

GET /Advertisers/{AccountSID}/PhoneNumbers HTTP/1.1
Host: api.impact.com
Authorization: Basic username:password
Accept: */*

200

A list of phone number objects.

{
  "PhoneNumbers": [
    {
      "Id": 12345,
      "Country": "US",
      "Number": "8051234567",
      "InternationalNumber": "[phone]",
      "DateCreated": "2026-01-15T10:00:00-08:00",
      "LastDateAssigned": "2026-02-01T10:00:00-08:00",
      "LastDateReleased": "2026-03-15T10:00:00-08:00",
      "Uri": "/Advertisers/<AccountSID>/PhoneNumbers/12345"
    }
  ]
}

Retrieve a Phone Number

get

Retrieves the details of a single phone number by its unique ID.

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

AccountSIDstringRequired

Your unique Account SID.

PhoneNumberIdintegerRequired

The unique identifier for the phone number.

Responses

200

A single phone number object.

application/json

IdintegerOptional

Unique identifier for the phone number (Phone Number ID).

Example: 12345

CountrystringOptional

Two-letter country code (ISO 3166).

Example: US

NumberstringOptional

The full phone number.

Example: 8051234567

InternationalNumberstringOptional

The full phone number with the international prefix.

Example: [phone]

DateCreatedstring · date-time · nullableOptional

The date and time the phone number was created.

Example: 2026-01-15T10:00:00-08:00

LastDateAssignedstring · date-time · nullableOptional

The date and time the phone number was last assigned to a partner.

Example: 2026-02-01T10:00:00-08:00

LastDateReleasedstring · date-time · nullableOptional

The date and time the phone number was last released from a partner.

Example: 2026-03-15T10:00:00-08:00

Uristring · uri-referenceOptional

The URI path to this phone number object.

Example: /Advertisers/<AccountSID>/PhoneNumbers/12345

get/Advertisers/{AccountSID}/PhoneNumbers/{PhoneNumberId}

HTTPcURLJavaScriptPython

GET /Advertisers/{AccountSID}/PhoneNumbers/{PhoneNumberId} HTTP/1.1
Host: api.impact.com
Authorization: Basic username:password
Accept: */*

200

A single phone number object.

{
  "Id": 12345,
  "Country": "US",
  "Number": "8051234567",
  "InternationalNumber": "[phone]",
  "DateCreated": "2026-01-15T10:00:00-08:00",
  "LastDateAssigned": "2026-02-01T10:00:00-08:00",
  "LastDateReleased": "2026-03-15T10:00:00-08:00",
  "Uri": "/Advertisers/<AccountSID>/PhoneNumbers/12345"
}