Skip to main content
TingTing uses two distinct types of phone numbers:
  • Broker phone numbers are the caller IDs displayed to recipients when your outbound campaigns dial out. These are shared numbers managed by TingTing on your behalf.
  • Active phone numbers are the phone numbers assigned directly to your account. These identify your account within the platform.
The id returned by both endpoints is used as the user_phone field when creating a campaign.

​
Authentication

All requests require a Bearer token in the Authorization header. See Authentication for details.

​
List active broker phone numbers

Returns the broker phone numbers assigned to your account. These numbers appear as the caller ID on outbound calls made through your campaigns. 
GET https://app.tingting.io/api/v1/active-broker-phone/

​
Response fields

​
id
integer
Unique identifier for the broker phone number. Use this value as user_phone when creating a campaign.
​
phone_number
string
The broker phone number in E.164 format (e.g. "+97715970425").
curl --request GET \
  --url "https://app.tingting.io/api/v1/active-broker-phone/" \
  --header "Authorization: Bearer <token>"

[
    {
        "id": 1,
        "phone_number": "+97715970425"
    }
]

​
List active phone numbers

Returns the active phone numbers assigned to your account. 
GET https://app.tingting.io/api/v1/phone-number/active/

​
Response fields

​
id
integer
Unique identifier for the phone number. Use this value as user_phone when creating a campaign.
​
phone_number
string
The phone number in E.164 format (e.g. "+97715970425").
curl --request GET \
  --url "https://app.tingting.io/api/v1/phone-number/active/" \
  --header "Authorization: Bearer <token>"

[
    {
        "id": 1,
        "phone_number": "+97715970425"
    }
]