---
updatedAt: 2026-05-14T14:36:14.000Z
agentTools:
projectIndex: https://docs.talkdesk.com/llms.txt
---
# List Campaign Numbers
Returns the phone numbers assigned to a specific campaign.
Use this endpoint to view which numbers are currently associated with a campaign.
Supports pagination and filtering by number ID.
# OpenAPI definition
```json
{
"openapi": "3.0.2",
"info": {
"title": "Public API",
"version": "5.12.71",
"description": "Documents public API endpoints. Scopes are given to external software, that we don't control",
"contact": {
"name": "Talkdesk",
"url": "https://talkdesk.com"
}
},
"servers": [
{
"url": "https://api.talkdeskapp.com",
"description": "United States (td-us-1)"
},
{
"url": "https://api.talkdeskapp.eu",
"description": "Europe (td-eu-1)"
},
{
"url": "https://api.talkdeskappca.com",
"description": "Canada (td-ca-1)"
},
{
"url": "https://api.talkdeskapp.co.uk",
"description": "United Kingdom (td-uk-1)"
}
],
"tags": [
{
"name": "Campaign Management API",
"description": "Campaign Management API"
}
],
"paths": {
"/campaigns/{id}/numbers": {
"get": {
"operationId": "campaigns-id-numbers-get",
"summary": "List Campaign Numbers",
"description": "Returns the phone numbers assigned to a specific campaign.\nUse this endpoint to view which numbers are currently associated with a campaign.\nSupports pagination and filtering by number ID.\n",
"x-namespace": "/campaigns",
"tags": [
"Campaign Management API"
],
"x-internal": false,
"parameters": [
{
"name": "id",
"in": "path",
"description": "Campaign id",
"required": true,
"schema": {
"type": "string",
"minLength": 1,
"maxLength": 36
}
},
{
"in": "query",
"name": "page",
"schema": {
"type": "integer",
"default": 1,
"minimum": 1,
"maximum": 4611686018427388000
}
},
{
"in": "query",
"name": "per_page",
"schema": {
"type": "integer",
"default": 50,
"minimum": 1,
"maximum": 100
}
},
{
"in": "query",
"name": "filter",
"description": "Allows filtering by user ids. Beware of the limit of the url's length.
Example: - filter=id eq '3c3671b2-bf96-4cd9-8ec8-8359911d3d5c' or id eq '9404df4e-bac2-44c2-bc2c-efbabb3fccc4'
",
"schema": {
"type": "string",
"minLength": 1,
"maxLength": 2083,
"x-operators": [
"eq",
"or"
]
}
}
],
"responses": {
"200": {
"description": "Assigned Numbers returned successfully",
"content": {
"application/hal+json": {
"schema": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"minimum": 0,
"maximum": 4611686018427388000
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 4611686018427388000
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 4611686018427388000
},
"per_page": {
"type": "integer",
"minimum": 1,
"maximum": 250
},
"total_pages": {
"type": "integer",
"minimum": 1,
"maximum": 4611686018427388000
},
"_embedded": {
"type": "object",
"properties": {
"numbers": {
"type": "array",
"description": "The list of numbers",
"items": {
"type": "object",
"allOf": [
{
"type": "object",
"required": [
"id",
"phone_number"
],
"properties": {
"id": {
"type": "string",
"description": "The uuid of the number",
"maxLength": 36
},
"phone_number": {
"type": "string",
"description": "The phone number in E.164 format",
"maxLength": 15
}
}
}
],
"properties": {
"_links": {
"type": "object",
"description": "HAL API related links.",
"required": [
"self"
],
"properties": {
"self": {
"type": "object",
"description": "Link to fetch the detail of the Campaign",
"required": [
"href"
],
"properties": {
"href": {
"type": "string",
"description": "Address of the resource"
}
}
},
"numbers": {
"type": "object",
"description": "Link to fetch a list of all the campaigns",
"required": [
"href"
],
"properties": {
"href": {
"type": "string",
"description": "Address of the resources"
}
}
}
}
}
},
"required": [
"_links"
]
}
}
},
"required": [
"numbers"
]
},
"_links": {
"type": "object",
"description": "HAL API related links.",
"required": [
"self"
],
"properties": {
"self": {
"type": "object",
"description": "Link to fetch a list of all the numbers",
"required": [
"href"
],
"properties": {
"href": {
"type": "string",
"description": "Address of the resources"
}
}
},
"prev": {
"type": "object",
"required": [
"href"
],
"properties": {
"href": {
"type": "string"
}
}
},
"next": {
"type": "object",
"required": [
"href"
],
"properties": {
"href": {
"type": "string"
}
}
},
"first": {
"type": "object",
"required": [
"href"
],
"properties": {
"href": {
"type": "string"
}
}
},
"last": {
"type": "object",
"required": [
"href"
],
"properties": {
"href": {
"type": "string"
}
}
}
}
}
},
"required": [
"total",
"count",
"page",
"per_page",
"total_pages",
"_embedded",
"_links"
]
},
"example": {
"total": 54,
"count": 4,
"page": 6,
"per_page": 10,
"total_pages": 6,
"_embedded": {
"numbers": [
{
"id": "88b69bad-8f19-4543-b38e-8e7c121ae04e",
"phone_number": "+44207183875044",
"_links": {
"self": {
"href": "http://api-docs.talkdesk.org/numbers/88b69bad-8f19-4543-b38e-8e7c121ae04e"
},
"numbers": {
"href": "http://api-docs.talkdesk.org/numbers"
}
}
}
]
},
"_links": {
"self": {
"href": "http://api-docs.talkdesk.org/campaigns/123e4567-e89b-12d3-a456-426655440000/numbers?page=3"
},
"prev": {
"href": "http://api-docs.talkdesk.org/campaigns/123e4567-e89b-12d3-a456-426655440000/numbers?page=2"
},
"next": {
"href": "http://api-docs.talkdesk.org/campaigns/123e4567-e89b-12d3-a456-426655440000/numbers?page=4"
},
"first": {
"href": "http://api-docs.talkdesk.org/campaigns/123e4567-e89b-12d3-a456-426655440000/numbers?page=1"
},
"last": {
"href": "http://api-docs.talkdesk.org/campaigns/123e4567-e89b-12d3-a456-426655440000/numbers?page=5"
}
}
}
}
}
},
"400": {
"description": "Errors were found in the submitted data.",
"content": {
"application/hal+json": {
"schema": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"description": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"description"
],
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
}
}
},
"example": {
"code": "0530001",
"message": "Errors were found in the submitted data"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/hal+json": {
"schema": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"description": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"description"
],
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
}
}
},
"example": {
"code": "0530004",
"message": "Missing or invalid authentication token"
}
}
}
},
"403": {
"description": "Forbidden",
"content": {
"application/hal+json": {
"schema": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"description": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"description"
],
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
}
}
},
"example": {
"code": "0530003",
"message": "Insufficient scopes for the requested operation"
}
}
}
},
"404": {
"description": "Campaign not found",
"content": {
"application/hal+json": {
"schema": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"description": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"description"
],
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
}
}
},
"example": {
"code": "0530002",
"message": "The requested resource could not be found"
}
}
}
}
}
}
}
},
"externalDocs": {
"description": "External Documentation",
"url": "https://api-docs.talkdeskapp.com/external_docs"
}
}
```