List contact groups

Preview

gethttps://api.expiryedge.com/v2/contact-groups

any member of an organization60/min

Request

curl 'https://api.expiryedge.com/v2/contact-groups?limit=50' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY"

Response

{
  "data": [
    {
      "id": "gro_123",
      "organization_id": "org_123",
      "name": "Example name",
      "color": "#1E88E5",
      "sort_order": 1,
      "created_by": "string",
      "created_at": "2026-09-27T14:05:00.000Z",
      "updated_at": "2026-09-27T14:05:00.000Z"
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

Stored groups ordered by id, cursor-paginated. Members are the contacts whose contact_group equals the group name (GET /v2/contacts and filter).

Query parameters

sortstring
Allowedid
cursorstring
Opaque next_cursor from the previous page. Only valid with the same sort.
limitinteger
Page size, 1-100 (values above 100 are clamped; default 50).
Default 50min: 1 · max: 100

Returns

200

A page of contact groups.

dataarray of objectsrequired
next_cursorstring | nullrequired
has_morebooleanrequired

Errors

`400`	Invalid parameters or body (`VALIDATION_FAILED`; `details` names the fields).
`401`	Missing, invalid or expired token (`UNAUTHORIZED`).
`403`	Your role can't do this, or your account has no organization (`FORBIDDEN`).
`405`	Wrong HTTP method for this path; the `Allow` header lists the valid ones.
`429`	Too many requests for this endpoint from your IP. Wait `Retry-After` seconds.