Lista distributionslistor

GET/api/v1/segments

Arbetsytans distributionslistor med antal. Kontakterna i en hämtas med GET /contacts?segment_id=.

Behörighet

segments:read Läsa distributionslistor – personen bakom nyckeln måste vara administratör.

Svar

200 Alla distributionslistor.

dataarray<object>krävs
data[].idstringkrävs
data[].namestringkrävs
data[].descriptionstring | nullkrävs
data[].matchingintegerkrävs: Kontakter som matchar villkoren just nu (inte raderade).
data[].activeintegerkrävs: Av dem: aktiva.
data[].created_atstring (tid, ISO 8601)krävs: När listan skapades.
data[].updated_atstring (tid, ISO 8601)krävs: När villkoren senast ändrades.

Fel

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

Anrop

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

Svar 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"
    }
  ]
}