Hosted numbers
Numbers your carrier holds for you. Import them onto a carrier connection so Signals knows which connection a call to each number belongs to, and remove them when they leave. A hosted block is routed like any other block. See Numbers your carrier holds.
List the project's hosted number blocks
Headers
Signals-VersionThe supported API snapshot to use for this request.
X-Project-IDThe project the request acts on, as prj_ and its lowercase UUID; optional while the
organization has one active project.
List the project's hosted number blocks › Responses
Every active hosted block of the project.
Import numbers the customer's carrier holds onto a carrier connection
Headers
Idempotency-KeyOne nonblank key of at most 128 characters; a retry with the same key repeats the outcome.
Signals-VersionThe supported API snapshot to use for this request.
X-Project-IDThe project the request acts on, as prj_ and its lowercase UUID; optional while the
organization has one active project.
Import numbers the customer's carrier holds onto a carrier connection › Request Body
connection_idThe carrier connection the numbers arrive through.
numbers1 to 5,000 distinct Nigerian E.164 numbers, such as +2348060000000.
Import numbers the customer's carrier holds onto a carrier connection › Responses
The numbers are imported as hosted blocks; calls go to the connection's trunk unless a block is routed.
importedRead a hosted number block with each number's last inbound call
path Parameters
block_idNumber block id
Headers
Signals-VersionThe supported API snapshot to use for this request.
X-Project-IDThe project the request acts on, as prj_ and its lowercase UUID; optional while the
organization has one active project.
Read a hosted number block with each number's last inbound call › Responses
The hosted block and its numbers.
connection_idconnection_nameendidimported_atlast_inbound_call_atThe project's newest inbound call to any number of the block, or null when it has none.
The block's routes, which override default_trunk for their numbers.
sizestartRemove a hosted number block; its numbers stop routing
path Parameters
block_idNumber block id
Headers
Idempotency-KeyOne nonblank key of at most 128 characters; a retry with the same key repeats the outcome.
Signals-VersionThe supported API snapshot to use for this request.
X-Project-IDThe project the request acts on, as prj_ and its lowercase UUID; optional while the
organization has one active project.
Remove a hosted number block; its numbers stop routing › Request Body
confirmMust be true: removal releases every number of the block.
Remove a hosted number block; its numbers stop routing › Responses
The block is released and its numbers removed.