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

List an API key's channels

GET/api-keys/{apiKey}/channels

Lists the numbered senders (Blooio and Twilio) the API key currently owns — the same lines the send layer will consider when a request authenticates with this key.

Blooio Apps (OAuth) only. Requires the apikeys:read scope. API-key and dashboard authentication are rejected with 403 oauth_token_required.

Path parameters

apiKeyRequiredstring

The API key value (prefixed with api_), as returned when the key was created or by the List API keys endpoint.

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

addressoptionalstring

The owned line in E.164, e.g. +15551234567. Usable as the {channel} reference on the assign/unassign endpoints and as from when sending.

typeoptionalstring

Provider of the line (blooio or twilio).

bannedoptionalboolean

Response codes

200The lines owned by this key.
401Your API key is missing or invalid. Pass it as a bearer token.
403Your API key isn't allowed to access this api key (blocked key or plan limit).
404No api key was found with the provided `apiKey`.

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/api-keys/sk_live_a1b2c3d4/channels \
Response objectexample
{  "data": [    {      "address": "123 Main St",      "type": "string",      "banned": false    }  ]}