Signals Docs
Signals API

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

GET
https://api.signals.pressone.africa
/numbers/hosted

List the project's hosted number blocks › Headers

Signals-Version
​string · enum · required

The supported API snapshot to use for this request.

Enum values:
2026-10-27
X-Project-ID
​string

The 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

POST
https://api.signals.pressone.africa
/numbers/hosted

Import numbers the customer's carrier holds onto a carrier connection › Headers

Idempotency-Key
​string · required

One nonblank key of at most 128 characters; a retry with the same key repeats the outcome.

Signals-Version
​string · enum · required

The supported API snapshot to use for this request.

Enum values:
2026-10-27
X-Project-ID
​string

The 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_id
​string · required

The carrier connection the numbers arrive through.

numbers
​string[] · required

1 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.

​HostedNumberImportBlock[] · required
imported
​integer · int32 · min: 0 · required

Read a hosted number block with each number's last inbound call

GET
https://api.signals.pressone.africa
/numbers/hosted/{block_id}

Read a hosted number block with each number's last inbound call › path Parameters

block_id
​string · required

Number block id

Read a hosted number block with each number's last inbound call › Headers

Signals-Version
​string · enum · required

The supported API snapshot to use for this request.

Enum values:
2026-10-27
X-Project-ID
​string

The 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_id
​string · required
connection_name
​string · required
​required
end
​string · required
id
​string · required
imported_at
​string · date-time · required
last_inbound_call_at
​string | null · date-time · required

The project's newest inbound call to any number of the block, or null when it has none.

​NumberRouteSlice[] · required

The block's routes, which override default_trunk for their numbers.

size
​integer · int32 · min: 0 · required
start
​string · required
​HostedNumber[] · required

Remove a hosted number block; its numbers stop routing

DELETE
https://api.signals.pressone.africa
/numbers/hosted/{block_id}

Remove a hosted number block; its numbers stop routing › path Parameters

block_id
​string · required

Number block id

Remove a hosted number block; its numbers stop routing › Headers

Idempotency-Key
​string · required

One nonblank key of at most 128 characters; a retry with the same key repeats the outcome.

Signals-Version
​string · enum · required

The supported API snapshot to use for this request.

Enum values:
2026-10-27
X-Project-ID
​string

The 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

confirm
​boolean · required

Must 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.

No data returned