Project API

Segments API

Read saved, live-evaluated audience queries.

Project key. Acts in the project the key belongs to. An all-access key works too — name the project with an X-Project-Id header. How keys and scopes work.

Endpoints

GET/v1/segments

GET/v1/segments/{id}

Segments are saved queries evaluated live, so they're read-only via the API — build them in the dashboard and target a campaign with a segment_id.

cURL

curl https://emailbump.com/api/v1/segments \
  -H "Authorization: Bearer ebk_your_key"

The list returns { "data": [...] }, and GET /v1/segments/{id} returns a single { "segment": {...} }.

200 response

{
  "segment": {
    "id": "2b1c9d7e-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
    "name": "Active in 30 days",
    "description": "Opened or clicked recently",
    "definition": { "match": "all", "conditions": [] },
    "created_at": "2026-07-21T19:56:38+00:00",
    "updated_at": "2026-07-21T19:56:38+00:00"
  }
}