Numbersv2

List phone numbers

GET/me/numbers

List all phone numbers bound to this API key with their availability status. 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

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 \  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "numbers": [    {      "phone_number": "+15551234567",      "is_active": true,      "last_active": "2025-01-15T09:30:00Z",      "plan_kind": "shared"    }  ]}