Cancel a number transfer
Cancels a transfer that hasn’t finished. Returns 409 once it has completed or closed.
Scopes: number:write
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
A unique key (a UUID works) for this request. Retrying with the same key returns the first answer instead of running twice.
255The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Path Parameters
Response
Successful Response
The transfer id.
Where the transfer stands.
Our team runs it with your carrier (outside the US).
The carrier receiving the numbers.
The numbers and their status.
ISO 8601.
ISO 8601.
The carrier's reference.
The carrier the numbers leave.
The date asked for (YYYY-MM-DD).
The status in plain words.
Why it failed.
When the numbers arrived.