Skip to main content
GET
curl

Authorizations

Authorization
string
header
required

A key generated from Settings → Developers, sent as Authorization: Bearer dr_live_<12 hex chars>_<64 hex chars>. Keys carry explicit scopes — each endpoint states the one it requires. The full key is shown exactly once at generation time and cannot be retrieved again; only the keyId prefix is shown afterward. A revoked key fails auth on its very next request.

Query Parameters

q
string

Only groups whose name contains this text (case-insensitive, up to 100 characters). Matched as plain text, so % and _ are not wildcards. Must not contain a NUL character (%00); one is rejected with VALIDATION_ERROR.

Maximum string length: 100
limit
integer
default:20

Groups per page. Values above 100 are treated as 100.

Required range: x >= 1
cursor
string

The nextCursor from the previous page.

Maximum string length: 512

Response

A page of groups.

data
object[]
required

The tags or groups on this page, each with its contact count.

nextCursor
string | null
required

Pass as cursor to get the next page. null on the last page.