sendsend.email
Sign inStart building

List a segment’s contacts

GET/v1/segments/{id}/contacts

The contacts that match now, with a total and cursor pagination.

Required scope: contacts:manage

Parameters

NameInDescription
idrequiredpathThe segment id.
limitoptionalqueryPage size, 1 to 100. Default 20.
cursoroptionalqueryThe next_cursor from a previous page.

Example

curl -X GET 'https://api.sendsend.email/v1/segments/ID/contacts' \
  -H "Authorization: Bearer $SENDSEND_API_KEY"

Response 200

{
  "object": "list",
  "total": 184,
  "has_more": true,
  "data": [
    {
      "id": "con_Hk3v…",
      "object": "contact",
      "audience_id": "aud_7Qe2…",
      "email": "maria@example.com",
      "first_name": "Maria",
      "last_name": null,
      "unsubscribed": false,
      "properties": {
        "plan": "pro"
      },
      "created_at": "2026-10-06T15:00:00.000Z",
      "updated_at": "2026-10-06T15:00:00.000Z"
    }
  ],
  "next_cursor": "con_Hk3v…"
}

Errors

StatusCodeWhen
404not_foundNo such resource in this project.
401unauthorizedThe API key is missing, invalid or revoked.
403forbiddenThe key does not have the scope this endpoint needs.

Every error has the same shape. See Errors.