Signals Docs
Signals API

Signals sells Nigerian numbers in blocks of consecutive numbers. Search for a block, hold it while you decide, accept its quote to buy it, then route its numbers to a trunk or a voice application. See Numbers and routing.


List assigned individual numbers

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

List assigned individual numbers › 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 assigned individual numbers › Responses

Every assigned number in the project.


List owned number blocks

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

List owned 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 owned number blocks › Responses

Every number block the project owns.


Hold an exact number block candidate

POST
https://api.signals.pressone.africa
/numbers/blocks/holds

Hold an exact number block candidate › 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.

Hold an exact number block candidate › Request Body

end
​string · required
size
​NumberBlockSize · enum · int32 · required
Enum values:
1
10
50
100
500
1000
start
​string · required
vanity_number
​string | null

Hold an exact number block candidate › Responses

The block is held with its quote.

block_id
​string · required
end
​string · required
expires_at
​string · date-time · required
held_at
​string · date-time · required
held_by
​string · required
id
​string · required
origin
​NumberHoldOrigin · enum · required
Enum values:
standard
vanity
​NumberQuote · required
size
​NumberBlockSize · enum · int32 · required
Enum values:
1
10
50
100
500
1000
start
​string · required
​required
​required

Search currently available number blocks

GET
https://api.signals.pressone.africa
/numbers/blocks/search

Search currently available number blocks › query Parameters

size
​integer · enum · int32 · required
Enum values:
1
10
50
100
500
1000
prefix
​string
patterns
​string
digits
​string
match
​string · enum
Enum values:
ends_with
contains
setup_up_to_minor
​integer · int64 · min: 0

Search currently available 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.

Search currently available number blocks › Responses

The matching block candidates with their prices.


Read an owned number block

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

Read an owned number block › path Parameters

block_id
​string · required

Number block id

Read an owned number block › 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 an owned number block › Responses

The number block with its slices and history.

​required
assigned
​integer · int32 · min: 0 · required
​required
​required
​required
detached_at
​string | null · date-time · required
end
​string · required
id
​string · required
monthly_minor
​integer | null · int64 · required
ordered_at
​string · date-time · required
origin
​NumberBlockOrigin · enum · required

entitlement marks the organization's included number: free, and never releasable. hosted marks numbers a carrier connection brings: no quote and no Signals rental.

Enum values:
standard
vanity
entitlement
hosted
quarantine_until
​string | null · date-time · required
quarantined
​integer · int32 · min: 0 · required
revision
​integer · int64 · required

The save revision the ETag quotes; send it back as If-Match.

​NumberRouteConsumer[] · required
size
​integer · int32 · min: 1 · max: 1000 · required

A Signals block holds 1, 10, 50, 100, 500 or 1000 numbers; a hosted block 1 to 1000.

start
​string · required
status
​NumberBlockStatus · enum · required
Enum values:
reserved
active
pending_release
quarantined
tier
​string · required
next_charge_at
​string | null · date-time · required
​required
​NumberAuditEntry[] · required
​NumberRouteSlice[] · required
​required

Accept a held number quote

POST
https://api.signals.pressone.africa
/numbers/blocks/{block_id}/assign

Accept a held number quote › path Parameters

block_id
​string · required

Number block id

Accept a held number quote › 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.

Accept a held number quote › Request Body

quote_hash
​string · required
quote_id
​string · required

Accept a held number quote › Responses

The order was accepted behind a cash hold for its total; a paid order stays pending_charge until the hold is captured.

block_id
​string · required
currency
​CatalogCurrency · enum · required
Enum values:
NGN
order_id
​string · required
state
​NumberOrderState · enum · required
Enum values:
pending_charge
active
failed
total_minor
​integer · int64 · required

Release a number shopping hold

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

Release a number shopping hold › path Parameters

block_id
​string · required

Number block id

Release a number shopping hold › 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.

Release a number shopping hold › Responses

The hold was released.

No data returned

List assigned numbers in an owned block

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

List assigned numbers in an owned block › path Parameters

block_id
​string · required

Number block id

List assigned numbers in an owned block › 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 assigned numbers in an owned block › Responses

Every assigned number in the block.


Release an owned number block; its numbers stop routing on return

POST
https://api.signals.pressone.africa
/numbers/blocks/{block_id}/release

Release an owned number block; its numbers stop routing on return › path Parameters

block_id
​string · required

Number block id

Release an owned number block; its numbers stop routing on return › 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.

Release an owned number block; its numbers stop routing on return › Request Body

end
​string · required
start
​string · required

Release an owned number block; its numbers stop routing on return › Responses

The block as saved, pending release.

​required
assigned
​integer · int32 · min: 0 · required
​required
​required
​required
detached_at
​string | null · date-time · required
end
​string · required
id
​string · required
monthly_minor
​integer | null · int64 · required
ordered_at
​string · date-time · required
origin
​NumberBlockOrigin · enum · required

entitlement marks the organization's included number: free, and never releasable. hosted marks numbers a carrier connection brings: no quote and no Signals rental.

Enum values:
standard
vanity
entitlement
hosted
quarantine_until
​string | null · date-time · required
quarantined
​integer · int32 · min: 0 · required
revision
​integer · int64 · required

The save revision the ETag quotes; send it back as If-Match.

​NumberRouteConsumer[] · required
size
​integer · int32 · min: 1 · max: 1000 · required

A Signals block holds 1, 10, 50, 100, 500 or 1000 numbers; a hosted block 1 to 1000.

start
​string · required
status
​NumberBlockStatus · enum · required
Enum values:
reserved
active
pending_release
quarantined
tier
​string · required
next_charge_at
​string | null · date-time · required
​required
​NumberAuditEntry[] · required
​NumberRouteSlice[] · required
​required

List the number route slices of a block

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

List the number route slices of a block › path Parameters

block_id
​string · required

Number block id

List the number route slices of a block › 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 number route slices of a block › Responses

Every route slice in the block.


Replace selected number route slices; the routes are live on return

PUT
https://api.signals.pressone.africa
/numbers/blocks/{block_id}/routes

Replace selected number route slices; the routes are live on return › path Parameters

block_id
​string · required

Number block id

Replace selected number route slices; the routes are live on return › Headers

If-Match
​string · required

The quoted revision the caller last read, so a concurrent change answers 412.

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.

Replace selected number route slices; the routes are live on return › Request Body

Replace selected number route slices; the routes are live on return › Responses

The routes as saved.


List open number shopping holds

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

List open number shopping holds › 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 open number shopping holds › Responses

Every open shopping hold in the project.

​NumberHold[] · required

Read an immutable number quote

GET
https://api.signals.pressone.africa
/numbers/quotes/{quote_id}

Read an immutable number quote › path Parameters

quote_id
​string · required

Quote id

Read an immutable number quote › Headers

Signals-Version
​string · enum · required

The supported API snapshot to use for this request.

Enum values:
2026-10-27

Read an immutable number quote › Responses

The quote with its acceptance state.

currency
​CatalogCurrency · enum · required
Enum values:
NGN
expires_at
​string · date-time · required
id
​string · required
initial_minor
​integer · int64 · required
​NumberQuoteLine[] · required
monthly_minor
​integer · int64 · required
setup_minor
​integer · int64 · required
​NumberTierQuote[] · required
version
​integer · int64 · required
accepted_at
​string | null · date-time · required
block_id
​string · required
​required
quote_hash
​string · required
status
​NumberQuoteStatus · enum · required
Enum values:
accepted
active
expired

List number tiers with the project's prices

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

List number tiers with the project's prices › 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 number tiers with the project's prices › Responses

Every number tier with the project's prices and patterns.

​NumberTier[] · required

Read an assigned individual number

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

Read an assigned individual number › path Parameters

number_id
​string · required

Individual number id

Read an assigned individual number › 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 an assigned individual number › Responses

The individual number.

​required
assigned_at
​string · date-time · required
block_id
​string · required
id
​string · required
number
​string · required
​required
tier
​string · required