Docs
Numbersv2

List phone numbers

GET/me/numbers

List all phone numbers bound to this API key with their availability status. 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. Use the returned phone numbers as the :number path parameter for other /me/numbers/ endpoints.

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

numbersoptionalobject[]

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 (phone_numbers.banned_at is set).

suspendedoptionalboolean

True when the phone number is suspended. Independent of status: a line can be both banned and suspended, in which case status is banned.

statusoptionalstring

banned if the number is banned, otherwise suspended if it is suspended, otherwise active. An account block does not change this field; it only sets is_active to false.

"active""suspended""banned"
last_activeoptionalstring | null
plan_kindoptionalstring

Plan type the underlying allocation runs on. Sourced directly from allocation_pool.type — the enum mirrors the DB CHECK constraint (see migration 2026-05-09-inbound-plan.sql), so any value here is also a valid type stored in the database. inbound numbers are reply-only — outbound to a recipient (a contact for 1:1 chats, the group for group chats) requires that recipient to have messaged the number first (otherwise the send returns 403 inbound_only_no_prior_inbound). null indicates the underlying allocation predates the type column or is unattributed; clients should treat null the same as dedicated for routing decisions.

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

Response codes

200List of phone numbers
401Authentication required or invalid

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/v2/api/me/numbers \
Response objectexample
{  "numbers": [    {      "phone_number": "+15551234567",      "is_active": true,      "banned": false,      "suspended": false,      "status": "active",      "last_active": "2025-01-15T09:30:00Z",      "plan_kind": "shared"    }  ]}