Cancel number

This method will cancel your purchased number. The number you cancel will become available in the numbers pool for anyone to buy.

Authorizations:

API Key Header

Basic

IBSSO Token Header

OAuth 2

Scopes:

numbers:manage

Request rate limit:

1 requests / second (per account)

Learn more

path Parameters

numberKey

required

string

Unique ID of a number.

Responses

204

No Content

401

Unauthorized

403

Forbidden

404

Not Found

429

Too Many Requests

500

Internal Server Error

Use case: Making an appointment using 2-way SMS communication

Request samples

Example

cURL

Copy

curl -L -g -X DELETE 'https://{baseUrl}/numbers/1/numbers/{numberKey}' \
-H 'Authorization: {authorization}' \
-H 'Accept: application/json'

Response samples

Content type

Copy

Collapse all


{"requestError": 
{"serviceException": 
{"messageId": "UNAUTHORIZED",
"text": "Unauthorized"
}
}
}

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products