List distribution lists

GET/api/v1/segments

The workspace's distribution lists with counts. The contacts in one are fetched with GET /contacts?segment_id=.

Scope

segments:read Read distribution lists – the person behind the key must be administrator.

Response

200 All distribution lists.

dataarray<object>required
data[].idstringrequired
data[].namestringrequired
data[].descriptionstring | nullrequired
data[].matchingintegerrequired: Contacts that match the conditions right now (not deleted).
data[].activeintegerrequired: Of those: active.
data[].created_atstring (time, ISO 8601)required: When the list was created.
data[].updated_atstring (time, ISO 8601)required: When the conditions were last changed.

Errors

401: unauthenticated invalid_key key_revoked key_expired key_inactive
402: payment_required
403: insufficient_scope forbidden workspace_suspended
429: rate_limited
500: internal_error

Request

curl 'https://newsletter.qrona.se/api/v1/segments' \
  -H "Authorization: Bearer $QRONA_NEWSLETTER_KEY"

Response 200

{
  "data": [
    {
      "id": "9b2e4c1a-7d3f-4e8a-b6c5-1f0e2d3c4b5a",
      "name": "Kunder i Göteborg",
      "description": null,
      "matching": 412,
      "active": 398,
      "created_at": "2026-09-12T09:00:00.000Z",
      "updated_at": "2026-10-02T14:20:00.000Z"
    }
  ]
}