`POST https://api.dropcontact.com/v1/enrich/all`

Envoyez vos contacts à enrichir. L'API renvoie un `request_id` pour récupérer le résultat.

## Paramètres

| Nom | Emplacement | Type | Obligatoire | Description |
| --- | --- | --- | --- | --- |
| `hashedInputs` | query | boolean \| null | non | Ajoute le champ `hashedInputs` à la réponse. |

## Corps de la requête

Corps de la requête POST /v1/enrich/all.

| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `data` | liste de InputRecord | oui | Liste des contacts à enrichir, 250 maximum par requête. Retrouvez tous les champs possibles dans [Contact envoyé](/fr/reference/input-record/). |
| `data[].first_name` | string \| null | non | Prénom du contact. |
| `data[].last_name` | string \| null | non | Nom du contact. |
| `data[].full_name` | string \| null | non | Nom complet du contact. À utiliser quand le prénom et le nom ne sont pas fournis séparément. |
| `data[].civility` | string \| null | non | Civilité du contact (ex. M., Mme). |
| `data[].email` | string \| null | non | Adresse email du contact. Vérifiée et qualifiée pendant l'enrichissement. |
| `data[].linkedin` | string \| null | non | URL du profil LinkedIn du contact. |
| `data[].job` | string \| null | non | Intitulé de poste du contact. |
| `data[].job_function` | string \| null | non | Fonction du contact (grande catégorie du poste). |
| `data[].job_level` | string \| null | non | Niveau hiérarchique du contact (ex. manager, dirigeant). |
| `data[].mobile_phone` | string \| null | non | Numéro de téléphone mobile du contact. |
| `data[].location` | string \| null | non | Localisation du contact (ville, région ou pays). |
| `data[].company` | string \| null | non | Nom de l'entreprise. |
| `data[].website` | string \| null | non | URL du site web de l'entreprise. |
| `data[].siret_address` | string \| null | non | Adresse de l'entreprise (issue du registre SIRET français). |
| `data[].siret_zip` | string \| null | non | Code postal de l'entreprise (issu du registre SIRET français). |
| `data[].siret_city` | string \| null | non | Ville de l'entreprise (issue du registre SIRET français). |
| `data[].country` | string \| null | non | Pays de l'entreprise. |
| `data[].company_linkedin` | string \| null | non | URL LinkedIn de l'entreprise. |
| `data[].phone` | string \| null | non | Numéro de téléphone standard de l'entreprise. |
| `data[].company_turnover` | string \| null | non | Chiffre d'affaires annuel de l'entreprise. |
| `data[].company_results` | string \| null | non | Résultat annuel de l'entreprise. |
| `data[].nb_employees` | string \| null | non | Nombre de salariés. |
| `data[].num_siren` | string \| null | non | Code SIREN français (retourné sous le nom `siren` en sortie). |
| `data[].siret` | string \| null | non | Code SIRET français. |
| `data[].naf5_code` | string \| null | non | Code NAF/APE. |
| `data[].naf5_des` | string \| null | non | Libellé du code NAF/APE. |
| `data[].vat` | string \| null | non | Numéro de TVA. |
| `data[].industry` | string \| null | non | Secteur d'activité (LinkedIn). Disponible uniquement sur les plans Free et Growth. |
| `data[].employee_count` | string \| null | non | Nombre de salariés (LinkedIn). Disponible uniquement sur les plans Free et Growth. |
| `data[].custom_fields` | object \| null | non | Champs personnalisés libres, retournés tels quels dans le résultat enrichi. |
| `siren` | boolean | non | Ajoute le numéro SIREN et SIRET de l'entreprise au résultat. |
| `language` | string \| null | non | Langue du libellé de qualification des emails : `fr` ou `en`. Toute autre valeur donne `en`. |
| `custom_callback_url` | string \| null | non | URL de webhook propre à cette requête, appelée quand le résultat est prêt. Remplace l'URL de webhook par défaut pour cette requête. |

## Réponses

### 200 — Requête prise en compte

| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `error` | boolean | non | Indique si une erreur s'est produite. |
| `success` | boolean | non | Indique si la requête a été prise en compte. |
| `credits_left` | integer | oui | Nombre de crédits restants sur votre compte. |
| `request_id` | string | oui | Identifiant de la requête, à utiliser pour récupérer le résultat. |
| `hashedInputs` | liste de string \| null | non | Un jeton signé (JWT) par contact envoyé, dans l'ordre d'envoi. Chaque jeton contient les données d'entrée du contact. Présent seulement avec `hashedInputs=true`. |
| `data` | liste de PostRecord \| null | non | Contacts envoyés qui ont une erreur ou une alerte. Absent si aucun contact n'en a. |
| `data[].index` | integer | oui |  |
| `data[].errors` | RecordErrors \| null | non |  |
| `data[].warnings` | RecordWarnings \| null | non |  |

### 400 — Requête mal formée

| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `error` | boolean | non | Indique si une erreur s'est produite. |
| `reason` | string | oui | Raison de l'échec de la requête, ou pourquoi le résultat n'est pas encore prêt. |
| `success` | boolean | non | Toujours false. |

| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `reason` | string | oui |  |
| `status` | string | oui |  |
| `data` | liste de PostRecord | oui |  |
| `data[].index` | integer | oui |  |
| `data[].errors` | RecordErrors \| null | non |  |
| `data[].warnings` | RecordWarnings \| null | non |  |
| `error` | boolean | non |  |
| `success` | boolean | non |  |

### 401 — Clé API absente ou invalide

| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `error` | boolean | non | Indique si une erreur s'est produite. |
| `reason` | string | oui | Raison de l'échec de la requête, ou pourquoi le résultat n'est pas encore prêt. |
| `success` | boolean | non | Toujours false. |

### 403 — Accès refusé

| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `error` | boolean | non | Indique si une erreur s'est produite. |
| `reason` | string | oui | Raison de l'échec de la requête, ou pourquoi le résultat n'est pas encore prêt. |
| `success` | boolean | non | Toujours false. |

### 422 — Erreur de validation

| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `detail` | liste de ValidationError | non |  |
| `detail[].loc` | liste de string \| integer | oui |  |
| `detail[].msg` | string | oui |  |
| `detail[].type` | string | oui |  |

### 429 — Trop de requêtes, ou erreur temporaire de notre côté : réessayez dans quelques secondes

| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `error` | boolean | non | Indique si une erreur s'est produite. |
| `reason` | string | oui | Raison de l'échec de la requête, ou pourquoi le résultat n'est pas encore prêt. |
| `success` | boolean | non | Toujours false. |

### 500 — Erreur côté Dropcontact

| Champ | Type | Obligatoire | Description |
| --- | --- | --- | --- |
| `detail` | string | oui |  |