Sign in

v1

latestOpenAPI 3.0.32026-07-24156161.2 MB
Streams

Get all streams

List all streams in your account.

Authentication: TextPeak API key in the Authorization header (see Authentication in the API Overview).

get/streams

Query parameters

_pageinteger

Page number (1-based).

itemsPerPageinteger

Items per page.

Response

The list of streams.

idinteger

Unique stream identifier.

streamUidstring

Opaque stream UID.

namestring

Stream name.

descriptionstring

Free-text description.

type'MARKETING' | 'TRANSACTIONAL' | 'OTP' | 'TWO_WAY' | 'WHATSAPP_BUSINESS' | 'WHATSAPP_PRIVATE' | 'TELEGRAM_BOT' | 'TELEGRAM_PRIVATE' | 'WEBSOCKET' | 'VOICE'

Stream type.

callerIdstring

Caller ID — present only for VOICE streams.

ipAclstring

Comma/space-separated IP allow-list.

state'READY' | 'SENDING' | 'DRAFT' | 'DISABLED' | 'RESTRICTED'

Stream state.

Example response

[
  {
    "id": 5,
    "streamUid": "9f1c2d3e4b5a6789c0d1e2f3a4b5c6d7",
    "name": "Marketing UK",
    "description": "Outbound marketing to UK contacts",
    "type": "MARKETING",
    "callerId": "447700900123",
    "ipAcl": "192.0.2.10",
    "state": "READY",
    "streamTags": [
      {
        "id": 12,
        "value": "vip"
      }
    ]
  }
]