Channelsv4

List channels

GET/channels

Lists messaging channels for the organization. A channel_id (ch_...) is required to send messages.

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

typeoptionalChannelType

Filter by channel type.

"blooio""twilio""whatsapp""whatsapp_business""rcs_business""amb"

statusoptionalChannelStatus

Filter by channel status.

"pending_verification""active""suspended""banned""deprecated"

limitoptionalinteger

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

cursoroptionalstring

Opaque pagination cursor. Pass the next_cursor value from a previous response to fetch the next page; omit it on the first request.

Returns

dataoptionalChannel[]

Array of Channel

idoptionalstring

Channel id (ch_...).

typeoptionalstring

"blooio""twilio""whatsapp""whatsapp_business""rcs_business""amb"

display_addressoptionalstring | null

Human-readable sender address.

statusoptionalstring

"pending_verification""active""suspended""banned""deprecated"

capabilitiesoptionalChannelCapabilities

What a channel can do. Shape varies by channel type.

protocolsoptionalstring[]

contentoptionalstring[]

actionsoptionalstring[]

interactiveoptionalstring[]

gatesoptionalstring[]

created_atoptionalinteger

Epoch milliseconds.

has_moreoptionalboolean

next_cursoroptionalstring | null

Response codes

200A page of channels

400The request was malformed — check the path, query parameters, and body.

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/channels?type=blooio&status=pending_verification&limit=50&cursor=string \  -H "Authorization: Bearer bl_live_..."

Response objectexample

{  "data": [    {      "id": "ch_018f7b2a-1c3d-7e4f-9a2b-0c1d2e3f4a5b",      "type": "blooio",      "display_address": "+15551234567",      "status": "active",      "capabilities": {        "protocols": [          "imessage",          "sms",          "rcs"        ],        "content": [          "text",          "media"        ]      },      "created_at": 1718000000000    }  ],  "has_more": false,  "next_cursor": null}