Customer.io
v1.0.0
OpenAPI 3.1.0

List segments

US region

Client Libraries
Shell Curl

List segments

​

Retrieve a list of all of your segments.

Responses
  • application/json
  • 429

    Your request is over the 10-per-second limit.

Request Example for get/v1/segments
curl https://api.customer.io/v1/segments \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "segments": [
    {
      "id": 7,
      "deduplicate_id": "15:1492548073",
      "name": "Manual Segment 1",
      "description": "My first manual segment",
      "state": "events",
      "progress": null,
      "type": "manual",
      "tags": null,
      "created_at": 1552341937,
      "updated_at": 1552341937
    }
  ]
}

Returns an array of segments. Each object in the response represents an individual segment.