Skip to main content
GET
Get a number

Authorizations

Authorization
string
header
required

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

Kallabot-Version
enum<string>

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

Available options:
2026-11-07
Example:

"2026-11-07"

Path Parameters

number_id
string
required

Response

Successful Response

line
NumberLine · object
required
origin
string
required

kallabot, ported, ops or byoc.

routing
LineRouting · object
required
recent_calls
RecentCall · object[]
required

The last calls on it that you may see.

technical
Technical · object
required

Carrier references, for support.

actions
Actions · object
required

What you can do to it now, e.g. change_verification.

locality
string | null

The number's city, where known.

list_price
string | null

The carrier's monthly list price as a decimal string (e.g. "1.15"), for information.

currency
string | null

The list price's currency.

bundle
Bundle · object | null

The verification: id, name, stage, status, valid_until.

address
Address · object | null

The address on file for it.

trust
Trust · object | null

Caller ID branding and spam-label state.

emergency
Emergency · object | null

The emergency address state.