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

Send your contacts to enrich. The API returns a `request_id` to fetch the result.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `hashedInputs` | query | boolean \| null | no | Adds the `hashedInputs` field to the response. |

## Request body

Body of POST /v1/enrich/all.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array of InputRecord | yes | List of contacts to enrich, 250 max per request. |
| `data[].first_name` | string \| null | no | Contact first name. |
| `data[].last_name` | string \| null | no | Contact last name. |
| `data[].full_name` | string \| null | no | Contact full name. Use this when first and last name are not provided separately. |
| `data[].civility` | string \| null | no | Contact civility / title (e.g. Mr, Mrs). |
| `data[].email` | string \| null | no | Contact email address. Verified and qualified during enrichment. |
| `data[].linkedin` | string \| null | no | Contact LinkedIn profile URL. |
| `data[].job` | string \| null | no | Contact job title. |
| `data[].job_function` | string \| null | no | Contact job function (broad category of the role). |
| `data[].job_level` | string \| null | no | Contact seniority level (e.g. manager, executive). |
| `data[].mobile_phone` | string \| null | no | Contact mobile phone number. |
| `data[].location` | string \| null | no | Contact location (city, region or country). |
| `data[].company` | string \| null | no | Company name. |
| `data[].website` | string \| null | no | Company website URL. |
| `data[].siret_address` | string \| null | no | Company street address (from the French SIRET registry). |
| `data[].siret_zip` | string \| null | no | Company postal code (from the French SIRET registry). |
| `data[].siret_city` | string \| null | no | Company city (from the French SIRET registry). |
| `data[].country` | string \| null | no | Company country. |
| `data[].company_linkedin` | string \| null | no | Company LinkedIn URL. |
| `data[].phone` | string \| null | no | Company standard phone number. |
| `data[].company_turnover` | string \| null | no | Company annual revenue. |
| `data[].company_results` | string \| null | no | Company annual results. |
| `data[].nb_employees` | string \| null | no | Number of employees. |
| `data[].num_siren` | string \| null | no | French SIREN code (emitted as `siren` on output). |
| `data[].siret` | string \| null | no | French SIRET code. |
| `data[].naf5_code` | string \| null | no | NAF/APE code. |
| `data[].naf5_des` | string \| null | no | NAF/APE code description. |
| `data[].vat` | string \| null | no | VAT number. |
| `data[].industry` | string \| null | no | Industry (LinkedIn). Only available on the Free and Growth plans. |
| `data[].employee_count` | string \| null | no | Employee count (LinkedIn). Only available on the Free and Growth plans. |
| `data[].custom_fields` | object \| null | no | Arbitrary custom fields returned as-is in the enriched result. |
| `siren` | boolean | no | Adds the company's SIREN and SIRET numbers to the result. |
| `language` | string \| null | no | Language of the email qualification label: `fr` or `en`. Any other value gives `en`. |
| `custom_callback_url` | string \| null | no | Webhook URL for this request only, called when the result is ready. Replaces the default webhook URL for this request. |

## Responses

### 200 — Request accepted

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | boolean | no | Whether an error occurred. |
| `success` | boolean | no | Whether the request was accepted. |
| `credits_left` | integer | yes | Number of credits left on your account. |
| `request_id` | string | yes | Request ID, used to fetch the result. |
| `hashedInputs` | array of string \| null | no | One signed token (JWT) per contact sent, in the order sent. Each token holds the contact's input data. Only present with `hashedInputs=true`. |
| `data` | array of PostRecord \| null | no | Contacts sent that have an error or a warning. Missing when no contact has one. |
| `data[].index` | integer | yes |  |
| `data[].errors` | RecordErrors \| null | no |  |
| `data[].warnings` | RecordWarnings \| null | no |  |

### 400 — Malformed request

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | boolean | no | Whether an error occurred. |
| `reason` | string | yes | Why the request failed, or why the result is not ready yet. |
| `success` | boolean | no | Always false. |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `reason` | string | yes |  |
| `status` | string | yes |  |
| `data` | array of PostRecord | yes |  |
| `data[].index` | integer | yes |  |
| `data[].errors` | RecordErrors \| null | no |  |
| `data[].warnings` | RecordWarnings \| null | no |  |
| `error` | boolean | no |  |
| `success` | boolean | no |  |

### 401 — Missing or invalid API key

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | boolean | no | Whether an error occurred. |
| `reason` | string | yes | Why the request failed, or why the result is not ready yet. |
| `success` | boolean | no | Always false. |

### 403 — Access denied

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | boolean | no | Whether an error occurred. |
| `reason` | string | yes | Why the request failed, or why the result is not ready yet. |
| `success` | boolean | no | Always false. |

### 422 — Validation Error

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `detail` | array of ValidationError | no |  |
| `detail[].loc` | array of string \| integer | yes |  |
| `detail[].msg` | string | yes |  |
| `detail[].type` | string | yes |  |

### 429 — Too many requests, or temporary error on our side: try again in a few seconds

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `error` | boolean | no | Whether an error occurred. |
| `reason` | string | yes | Why the request failed, or why the result is not ready yet. |
| `success` | boolean | no | Always false. |

### 500 — Error on Dropcontact's side

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `detail` | string | yes |  |