Docs
BetaThe V4 API is in beta — endpoints and functionality may change.
Channelsv4

List available Blooio numbers

GET/channels/blooio/available

Browse Blooio number inventory available to purchase. type=shared returns available shared lines; type=dedicated returns unassigned dedicated inventory. When one or more area_code values are supplied with type=dedicated or type=inbound, the response is an area-code quote: each requested code is reported as either in stock (provisioned free) or requiring a custom order (a custom area-code fee applies and a provisioning ticket is opened at purchase). Requires the number purchase API feature to be enabled for the organization, and the numbers:read scope for OAuth apps.

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

Query parameters

typeoptionalstring

Plan family to browse.

"shared""dedicated""inbound"
area_codeoptionalstring

A desired 3-digit US area code. Repeat the parameter (or pass a comma-separated area_codes) to quote several. Only meaningful for dedicated/inbound.

countryoptionalstring

Filter inventory by ISO country code (e.g. US).

limitoptionalinteger

Maximum number of items to return per page. Must be between 1 and 200; defaults to 50. Combine with cursor to paginate.

Returns

dataoptionalobject[]
matched_countoptionalinteger

Quote mode only: requested area codes found in stock.

custom_order_countoptionalinteger

Quote mode only: requested area codes needing a custom (ticketed, billed) order.

has_moreoptionalboolean
next_cursoroptionalstring | null

Response codes

200Available inventory or an area-code quote
400The request was malformed — check the path, query parameters, and body.
401Your API key is missing or invalid. Pass it as a bearer token.
403Your API key isn't allowed to access this channel (blocked key or plan limit).

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/channels/blooio/available?type=shared&area_code=string&country=US&limit=50 \
Response objectexample
{  "data": [    {}  ],  "matched_count": 3,  "custom_order_count": 3,  "has_more": true,  "next_cursor": "string"}