List Segments

GET /segments Returns all active and draft static segments for your team. Only static segments are exposed via the External API. Supports keyset-based pagination.

curl "https://eapi.recotap.com/api/v1/segments?limit=100" \
  -H "X-Api-Key: your-api-key-here"

Query parameters

Parameter	Type	Description
`limit`	integer	Number of records to return. Default `100`.
`cursor`	string	Keyset cursor. Pass the `nextCursor` value from the previous response to fetch the next page.

Response data

{
  "data": [
    { "segmentId": "seg-001", "name": "Q2 Target Accounts", "status": "active" },
    { "segmentId": "seg-002", "name": "Draft Campaign List", "status": "draft" }
  ],
  "nextCursor": "seg-001",
  "hasNextPage": false
}

Field	Description
`nextCursor`	Pass this value as `cursor` on the next request to fetch the next page.
`hasNextPage`	`true` if more records exist beyond the current page.

Segment fields

Field	Description
`segmentId`	Recotap’s segment ID. Pass this as `segmentId` when calling Create Accounts.
`name`	Display name of the segment
`status`	`active` or `draft`

Getting Started

API Reference

Resources