# Gespeicherte Kontaktsuche abrufen (kostenlos) (https://webmetic.de/docs/api/referenz/contacts/lookup)

## GET /contacts/lookup

Kostenlos: liefert die gespeicherte Suche dieses Kontos für das Unternehmen
mit denselben Filtern. `{"exists": false}` wenn noch nicht gesucht wurde.
Treffer sind auf das Sitzland des Unternehmens eingegrenzt (`country`);
gab es dort keine, steht `country_fallback` und die Treffer sind weltweit.

### Parameter

| Name | Ort | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- | --- |
| `company_id` | query | string | ja | company_id eines Unternehmens, das Ihre Website besucht hat (aus /company-sessions oder /company) |
| `departments` | query | string \| null | nein | Abteilungen, kommagetrennt (Standard: ICP-Konfiguration des Kontos) |
| `seniority` | query | string \| null | nein | Senioritätsstufen, kommagetrennt, z. B. 9,10 (Standard: ICP-Konfiguration) |
| `require_email` | query | boolean | nein | Suche mit Filter 'nur mit E-Mail' |
| `require_phone` | query | boolean | nein | Suche mit Filter 'nur mit Rufnummer' |

### Antworten

| Status | Beschreibung |
| --- | --- |
| 200 | Ergebnis der letzten Suche dieses Kontos für die Domain, inklusive bereits freigeschalteter Daten |
| 403 | API-Key fehlt, ist ungültig oder unbekannt, FEATURE_DISABLED (Datenprofile ist für Ihr Konto ausgeschaltet), COMPANY_NOT_IDENTIFIED (das Unternehmen hat Ihre Website nicht besucht) oder PLAN_REQUIRED (im Free-Plan verborgenes Unternehmen) |
| 404 | COMPANY_WITHOUT_WEBSITE: keine Website zum Unternehmen bekannt |
| 422 | VALIDATION_ERROR: ein Parameter fehlt oder ist ungültig; `errors` nennt jedes Problem |
| 500 | INTERNAL_ERROR: unerwarteter Serverfehler |

Felder der Antwort 200:

| Feld | Typ | Pflicht | Beschreibung |
| --- | --- | --- | --- |
| `exists` | boolean | ja | false: dieses Konto hat mit diesen Filtern noch nicht gesucht |
| `request_id` | string \| null | nein | Veraltet, nur zur Information |
| `total_results` | integer \| null | nein | Treffer der Suche insgesamt |
| `contacts` | ContactBasic[] \| null | nein | Die gespeicherten Treffer mit bereits freigeschalteten Daten |
| `contacts[].contact_id` | string | ja | Opake, dauerhafte Kennung (z. B. v1.abc) |
| `contacts[].name` | string \| null | nein | Vor- und Nachname |
| `contacts[].job_title` | string \| null | nein | Position im Unternehmen |
| `contacts[].company_name` | string \| null | nein | Unternehmen des Kontakts |
| `contacts[].has_email` | boolean | nein | true: eine E-Mail-Adresse liegt vor und kann freigeschaltet werden |
| `contacts[].has_phone` | boolean | nein | true: eine Rufnummer liegt vor und kann freigeschaltet werden |
| `contacts[].has_social_link` | boolean | nein | true: ein LinkedIn-Profil liegt vor |
| `contacts[].email` | string \| null | nein | E-Mail-Adresse; null, bis sie freigeschaltet ist |
| `contacts[].linkedin` | string \| null | nein | LinkedIn-Profil; null, bis es mit der E-Mail freigeschaltet ist |
| `contacts[].direct_phone` | string \| null | nein | Durchwahl; null, bis die Rufnummern freigeschaltet sind |
| `contacts[].mobile_phone` | string \| null | nein | Mobilnummer; null, bis die Rufnummern freigeschaltet sind |
| `created_at` | string \| null | nein | Zeitpunkt der Suche |
| `country` | string \| null | nein | ISO-Ländercode des Unternehmenssitzes, auf den die Treffer eingegrenzt sind; null = weltweit |
| `country_fallback` | boolean \| null | nein | Nur bei Treffern: true, wenn es im Sitzland keine gab und die Treffer weltweit sind |

### Beispiel

```bash
curl -X GET 'https://hub.webmetic.de/contacts/lookup?company_id=41ea486a9c95' \
  -H 'Authorization: wmtc_IHR_API_SCHLUESSEL'
```