Get contact

GET/api/v1/contacts/{id}

A contact with the lists it is on.

Scope

contacts:read Read contacts – the person behind the key must be all members.

Path parameters

idstringrequired: The contact's ID.

Response

200 The contact.

idstringrequired: The contact's ID.
emailstringrequired: The email address (lower case). Never changes: consents and suppressions apply to the address.
first_namestring | nullrequired
last_namestring | nullrequired
companystring | nullrequired
phonestring | nullrequired: In international format (E.164), e.g. +46701234567.
statusstringrequired: active: can receive mailings · unsubscribed: has unsubscribed from everything · bounced: the address bounces · complained: has reported spam · deleted: erased (GDPR), the personal data is gone.activeunsubscribedbouncedcomplaineddeleted
fieldsobject<string | number | boolean>required: Custom fields by key (see GET /fields). Sensitive fields, such as personal identity numbers, are never sent out.
tagsarray<string>required
sourcestringrequired: How the contact was added: manual, import, form, api …
consentobjectrequired
consent.atstring (time, ISO 8601) | nullrequired: When consent was given.
consent.sourcestring | nullrequired: How the person consented, in your own words.
suppressionobject | nullrequired: The workspace's suppression of the address. A suppressed address never receives mailings, regardless of status.
suppression.reasonstringrequired: unsubscribed, bounced, complained, manual or imported.
suppression.created_atstring (time, ISO 8601)required: When the address was suppressed.
sharedbooleanrequired: Shared from a level above in the organisation: can be read and receive mailings from here, but can only be changed where it belongs.
created_atstring (time, ISO 8601)required: When the contact was created.
updated_atstring (time, ISO 8601)required: When the contact was last changed.
unsubscribed_atstring (time, ISO 8601) | nullrequired: When the person unsubscribed.
listsarray<object>required: The workspace's lists that the contact is on. Empty for a shared contact.
lists[].list_idstringrequired
lists[].namestringrequired
lists[].statusstringrequired: subscribed: on the list · pending: waiting to confirm by email · unsubscribed: has left the list.subscribedpendingunsubscribed
lists[].subscribed_atstring (time, ISO 8601) | nullrequired: When the person joined the list.

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/contacts/1042' \
  -H "Authorization: Bearer $QRONA_NEWSLETTER_KEY"

Response 200

{
  "id": "1042",
  "email": "anna@example.se",
  "first_name": "Anna",
  "last_name": "Svensson",
  "company": "Example Ltd",
  "phone": "+46701234567",
  "status": "active",
  "fields": {
    "kundnummer": "K-2041",
    "ort": "Göteborg"
  },
  "tags": [
    "kund",
    "vip"
  ],
  "source": "api",
  "consent": {
    "at": "2026-10-19T08:30:00.000Z",
    "source": "Ticked the box at checkout on butik.se"
  },
  "suppression": null,
  "shared": false,
  "created_at": "2026-10-19T08:30:00.000Z",
  "updated_at": "2026-10-19T08:30:00.000Z",
  "unsubscribed_at": null,
  "lists": [
    {
      "list_id": "3f1c2a4e-8b7d-4c1e-9f0a-2d6b5e7c8a91",
      "name": "Nyhetsbrev",
      "status": "subscribed",
      "subscribed_at": "2026-10-19T08:30:00.000Z"
    }
  ]
}