Slå upp kontakter på e-post

POST/api/v1/contacts/lookup

Upp till 100 adresser i ett anrop. Svaret har de kontakter som finns (alla statusar, även raderade).

Adresserna skickas i kroppen så att de inte hamnar i loggar. En adress kan ge två träffar: en egen kontakt och en delad från en nivå ovanför.

Behörighet

contacts:read Läsa kontakter – personen bakom nyckeln måste vara alla medlemmar.

Kropp

JSON, Content-Type: application/json. Okända fält ger 422.

emailsarray<string>krävs: Upp till 100 adresser.minst 1 · högst 100 st

Göra om anropet

Skicka gärna headern Idempotency-Key (t.ex. ett uuid). Skickas samma anrop igen med samma nyckel inom 24 timmar kommer det första svaret tillbaka, utan att något görs två gånger. Batch och idempotens

Svar

200 Kontakterna som finns.

dataarray<object>krävs
data[].idstringkrävs: Kontaktens id.
data[].emailstringkrävs: E-postadressen (gemener). Ändras aldrig: samtycken och spärrar gäller adressen.
data[].first_namestring | nullkrävs
data[].last_namestring | nullkrävs
data[].companystring | nullkrävs
data[].phonestring | nullkrävs: I internationellt format (E.164), t.ex. +46701234567.
data[].statusstringkrävs: active: kan få utskick · unsubscribed: har avregistrerat sig från allt · bounced: adressen studsar · complained: har anmält skräppost · deleted: raderad (GDPR), personuppgifterna är borta.activeunsubscribedbouncedcomplaineddeleted
data[].fieldsobject<string | number | boolean>krävs: Egna fält efter nyckel (se GET /fields). Känsliga fält, som personnummer, skickas aldrig ut.
data[].tagsarray<string>krävs
data[].sourcestringkrävs: Hur kontakten kom in: manual, import, form, api …
data[].consentobjectkrävs
data[].consent.atstring (tid, ISO 8601) | nullkrävs: När samtycket gavs.
data[].consent.sourcestring | nullkrävs: Hur personen samtyckte, med egna ord.
data[].suppressionobject | nullkrävs: Arbetsytans spärr på adressen. En spärrad adress får aldrig utskick, oavsett status.
data[].suppression.reasonstringkrävs: unsubscribed, bounced, complained, manual eller imported.
data[].suppression.created_atstring (tid, ISO 8601)krävs: När adressen spärrades.
data[].sharedbooleankrävs: Delad från en nivå ovanför i organisationen: kan läsas och få utskick härifrån, men bara ändras där den hör hemma.
data[].created_atstring (tid, ISO 8601)krävs: När kontakten skapades.
data[].updated_atstring (tid, ISO 8601)krävs: När kontakten senast ändrades.
data[].unsubscribed_atstring (tid, ISO 8601) | nullkrävs: När personen avregistrerade sig.

Fel

400: bad_request
401: unauthenticated invalid_key key_revoked key_expired key_inactive
402: payment_required
403: insufficient_scope forbidden workspace_suspended
409: idempotency_in_progress
415: unsupported_media_type
422: validation_failed idempotency_key_reused
429: rate_limited
500: internal_error

Anrop

curl -X POST 'https://newsletter.qrona.se/api/v1/contacts/lookup' \
  -H "Authorization: Bearer $QRONA_NEWSLETTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails":["anna@example.se","bo@example.se"]}'

Svar 200

{
  "data": [
    {
      "id": "1042",
      "email": "anna@example.se",
      "first_name": "Anna",
      "last_name": "Svensson",
      "company": "Exempel AB",
      "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": "Kryssade i rutan i kassan på 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
    }
  ]
}