Get distribution list

GET/api/v1/segments/{id}

A distribution list with counts.

Scope

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

Path parameters

idstringrequired: The distribution list's ID.

Response

200 The distribution list.

idstringrequired
namestringrequired
descriptionstring | nullrequired
matchingintegerrequired: Contacts that match the conditions right now (not deleted).
activeintegerrequired: Of those: active.
created_atstring (time, ISO 8601)required: When the list was created.
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
404: not_found
429: rate_limited
500: internal_error

Request

curl 'https://newsletter.qrona.se/api/v1/segments/3f1c2a4e-8b7d-4c1e-9f0a-2d6b5e7c8a91' \
  -H "Authorization: Bearer $QRONA_NEWSLETTER_KEY"

Response 200

{
  "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"
}