Skip to main content

Get Segment

Retrieve a specific segment by UUID, including its audience size.

Request​

GET /segments/{uuid}

Path Parameters​

ParameterTypeDescription
uuidstringSegment's UUID

Example Request​

curl -X GET "https://email.easy.tools/api/v1/segments/60707a92-80d0-468e-8a13-38b90c0511db" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Response​

Success Response (200 OK)​

{
  "data": {
    "uuid": "60707a92-80d0-468e-8a13-38b90c0511db",
    "name": "Lapsed buyers",
    "contacts_count": 1284,
    "contacts_count_calculated_at": "2026-06-26T08:12:03Z",
    "created_at": "2026-02-10T14:20:00Z",
    "updated_at": "2026-06-25T09:01:11Z"
  }
}

Response Fields​

The segment has the fields described in Segment Object.

Error Responses​

Not Found Error (404)​

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Segment with uuid '60707a92-80d0-468e-8a13-38b90c0511db' not found"
  }
}