Get Numbers

To a campaign

📘

Supported Regions and Base URLs

👍

Access and Registration

Authentication

Scope

campaigns:read

Body Response - Schema

200 (assigned numbers returned successfully)

ParameterTypeDescriptionRequired
totalinteger

= 0
<= 4611686018427388000

yes
countinteger

= 0
<= 4611686018427388000

yes
pageinteger

= 1
<= 4611686018427388000

yes
per_pageinteger

= 1
<= 250

yes
total_pagesinteger

= 1
<= 4611686018427388000

yes
_embeddedobject

"_embedded" subdivides into:

1 - "numbers" (array[object]) - the list of numbers. Required.

1.1 - "_links" (object) - HAL API related links.

1.1.1 - "self" (object) - link to fetch the detail of the campaign.
1.1.1.1 - "href" (string) - address of the resource.

= 78 characters
<= 78 characters
Required.

1.1.2 - "numbers" (object) - link to fetch a list of all the campaigns.
1.1.2.1 - "href" (string) - address of the resource.

= 41 characters
<= 41 characters
Required.

1.2 - "id" (string) - the uuid of the number. Required.

1.3 - "phone_number" (string) - the phone number in E.164 format.
<= 15 characters Required.

_linksobject

HAL API related links. "_links" subdivides into:

1 - "self" (object) - link to fetch a list of all numbers.
1.1 - "href" (string) - address of the resources.
Required.

2 - "prev" (object)
2.1 - "href" (string) - required.

3 - "next" (object)
3.1 - "href" (string) - required.

4 - "first" (object) -
4.1 - "href" (string) -
required.

5 - "last" (object) -
5.1 - "href" (string) -
required.

yes

400 (errors found in the submitted data), 401 (unauthorized), 403 (forbidden), 404 (campaign not found)

ParameterTypeDescriptionRequired
codestringn/ayes
messagestringn/ayes
descriptionstringn/ano
fieldsarray[object]

"fields" subdivides into:

"name" (string)

"description" (string)

yes (name and description)
❗️

API Availability

The Campaign Management API is only available for customers enrolled in Talkdesk's Early Access (EA) program.
To enter the EA program, contact a Customer Success Manager.

The Campaign Management APII has been in EA since November 2022.

🚧

Troubleshooting

If you have any questions regarding the usage of this API, or if you’re having any technical issues, please open a ticket using this form.

Language
Credentials
Header
Click Try It! to start a request and see the response here!