Docs
Accountv4

List sender numbers

GET/me/numbers

Lists the phone numbers / sender addresses available to this API key. Banned and suspended numbers stay in the list. status is banned, suspended, or active; a ban takes precedence when both apply. is_active is false when the line is banned, suspended, or the underlying account is blocked.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Returns

dataoptionalobject[]

Array of object

phone_numberoptionalstring
is_activeoptionalboolean

False when the line is banned, suspended, or the underlying account is blocked.

bannedoptionalboolean

True when the phone number is banned.

suspendedoptionalboolean

True when the phone number is suspended. A line can be both banned and suspended; status is then banned.

statusoptionalstring

banned if the number is banned, otherwise suspended if it is suspended, otherwise active.

"active""suspended""banned"
last_activeoptionalinteger | null

Epoch milliseconds of the allocation's last activity.

plan_kindoptionalstring

Plan type the underlying allocation runs on. inbound numbers are reply-only.

"shared""dedicated""inbound""trial""2fa"null

Response codes

200Sender numbers
401Your API key is missing or invalid. Pass it as a bearer token.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request
curl -X GET https://api.blooio.com/v4/me/numbers \
Response objectexample
{  "data": [    {      "phone_number": "+15551234567",      "is_active": true,      "banned": false,      "suspended": false,      "status": "active",      "last_active": 0,      "plan_kind": "shared"    }  ]}