Kontakt abrufen

GET /contacts/{contactId}

Ruft die vollständigen Daten eines bestimmten Kontakts (Patient:in oder Kund:in) anhand seiner contactId ab.

Erforderliche Header

Authorization: Bearer {{ token }}
Accept: application/json
Version: 2021-07-28 // API-Version für Kontakte

URL-Parameter

Ersetze contactId mit der ID des Kontakts, den du abrufen möchtest. Diese ID erhältst du z. B. über „Upsert Contact“ oder aus dem CRM.

# Beispiel-Aufruf
.../contacts/ocQHyuzHvysMo5N5VsXc

Beispiel (cURL)

curl -L 'https://services.leadconnectorhq.com/contacts/ocQHyuzHvysMo5N5VsXc' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {{ token }}' \
  -H 'Version: 2021-07-28'

Mögliche Antworten (Response)

Antwort (200 OK): Kontakt-Objekt

Bei erfolgreichem Abruf wird ein vollständiges contact-Objekt zurückgegeben.

{
  "contact": {
    "id": "ocQHyuzHvysMo5N5VsXc",
    "firstName": "Leonard",
    "lastName": "Luzhnica",
    "email": "[email protected]",
    "phone": "+4915123456789",
    "gender": "male",
    "customFields": {
      "insurance": "Barmer",
      "location": "SOKAI, Pfarrer-Perabo-Platz 6, 60326 Frankfurt"
    },
    "createdAt": "2025-07-07T15:02:00+02:00",
    "updatedAt": "2025-10-25T12:33:00+02:00"
  }
}

Mögliche Fehler

401 Unauthorized – Token fehlt oder ist ungültig
404 Not Found – Kontakt mit dieser ID existiert nicht
422 Unprocessable Entity – Pflichtfelder oder Parameter fehlen