List segments

List segments with sorting and cursor-based pagination support.

Scopes:
segments.read

Pagination:
This endpoint uses cursor-based pagination. Use the after cursor from the response to get the next page,
or the before cursor to get the previous page. Do not use both after and before parameters simultaneously.

Sorting:

  • Only single-field sorting is supported. You cannot sort by multiple fields.
  • Available sort fields: createdAt (default), name.
  • When sorting by name, segments are sorted lexicographically (case-sensitive).
  • Sort parameters are only required on the first request. Subsequent requests using a cursor
    will automatically use the sort settings embedded in the cursor.

Cursor Behavior:

  • Cursors are self-contained and include all parameters needed for pagination.
  • Once you have a cursor, you only need to pass the cursor for subsequent pages.
  • If sort parameters are provided with a cursor, they must match the cursor's sort settings.
  • Cursors may become invalid if the underlying data changes significantly (e.g., the referenced segment is deleted).

Rate Limiting:
This endpoint is rate limited to 100 requests per minute.

Query Params
integer
1 to 50
Defaults to 10

Page size (1-50)

string

Cursor for next page (base64-encoded, obtained from previous response)

string

Cursor for previous page (base64-encoded, obtained from previous response)

string
enum
Defaults to createdAt

Sort field (only needed on first request)

Allowed:
string
enum
Defaults to desc

Sort direction (only needed on first request)

Allowed:
Headers
string
required
Defaults to 2026-03-15

API version that specifies the response format and behaviour (e.g., 2026-preview)

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json