contacts

List segments

Read-only smart audiences. Pass a segment id to campaign sends; membership is evaluated at send time.

match is the rule combinator (all = every rule, any = at least one). The rule DSL itself is managed in the dashboard.

Page with ?limit= (max 200, default 200) and ?cursor= (the previous page's next_cursor); segments are ordered by name.

get/api/v1/segments

Request

  • Base URL: https://app.blueticked.com
  • URL: https://app.blueticked.com/api/v1/segments
  • Auth: HTTP bearer

Query parameters

limitinteger

Maximum number of items to return.

cursorstring

Opaque pagination cursor. Pass the next_cursor from a previous response; do not construct it yourself.

Response

Success

next_cursorstring nullable required
has_moreboolean required
request_idstring required

Example response

{
  "data": [
    {
      "id": "265eb527-0b2b-4c8c-a6b1-6ac9acc1a689",
      "name": "Engaged last 30 days",
      "created_at": "2026-05-22T10:30:00.000Z",
      "updated_at": "2026-05-22T10:30:00.000Z"
    }
  ],
  "request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}

Changes

No recorded changes to this operation across all 1 revision of this API.