Skip to main content
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
ParameterTypeDescription
limitintegerNumber of records to return. Default 100.
cursorstringKeyset 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
}
FieldDescription
nextCursorPass this value as cursor on the next request to fetch the next page.
hasNextPagetrue if more records exist beyond the current page.
Segment fields
FieldDescription
segmentIdRecotap’s segment ID. Pass this as segmentId when calling Create Accounts.
nameDisplay name of the segment
statusactive or draft