> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leads-siren.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enrich Single

Synchronously enrich data for a single company identified by its SIREN number. Returns the enriched data directly in the response.

<Note>
  **Choosing between `/enrich-single` and [`/siren-enrich`](./siren-enrich):**

  Both endpoints take a SIREN and return contact info for its dirigeants. They use different matching engines and have different trade-offs.

  |                                        | `/enrich-single` (this endpoint) | [`/siren-enrich`](./siren-enrich)                            |
  | -------------------------------------- | -------------------------------- | ------------------------------------------------------------ |
  | Matching engine                        | Legacy enrichment engine         | Les Pages Rouges (LPR) + Pappers pipeline                    |
  | Per-row confidence score               | ❌ not exposed                    | ✅ `score` + `statut` (`Certain` / `Probable` / `À vérifier`) |
  | DOB-mismatch elimination               | ❌ no                             | ✅ candidates with divergent DOBs are dropped                 |
  | Siege address fallback                 | ❌ no                             | ✅ falls back to company siege when personal address is null  |
  | `status_filter` (`current` / `former`) | ✅ supported                      | ⚠️ accepted but not honored                                  |
  | Audit/debug data per row               | ❌ no                             | ✅ `lpr_debug.breakdown`                                      |

  **Use this endpoint** when you need `status_filter` or want the legacy enrichment behavior.
  **Use [`/siren-enrich`](./siren-enrich)** for new integrations — it returns a transparent confidence score per row so you can gate on `Certain` / `Probable` matches and avoid paying for low-confidence ones.
</Note>

## Request Body

<ParamField body="data" type="object">
  <Expandable title="properties">
    <ParamField body="siren" type="string" required>
      The 9-digit SIREN number of the company to enrich.
    </ParamField>

    <ParamField body="skip_contact_search" type="boolean" default="false">
      When `true`, skips the contact information lookup (email and phone). Only the per-SIREN lookup cost applies — no email (5 credits) or phone (90 credits) charges.
    </ParamField>

    <ParamField body="role_types" type="string[]">
      Filter executives by role. Accepts **role group names** or individual role labels.

      **Role groups:** `"Executives"`, `"Governance & Audit"`, `"Shareholders & Other"`, `"Liquidator"`, `"All"`

      **Individual labels:**
      `"Président"`, `"Directeur général"`, `"Directeur général délégué"`, `"Gérant"`,
      `"Gérant et associé indéfiniment responsable"`, `"Président du conseil d'administration"`,
      `"Membre du directoire"`, `"Chef d'entreprise"`,
      `"Administrateur"`, `"Membre du conseil de surveillance"`,
      `"Commissaire aux comptes titulaire"`, `"Commissaire aux comptes suppléant"`,
      `"Membre"`, `"Associé indéfiniment responsable"`, `"Autre"`,
      `"Liquidateur"`
    </ParamField>

    <ParamField body="status_filter" type="string">
      Filter by executive status. `"current"` for active, `"former"` for former, `"all"` or omit for both.
    </ParamField>
  </Expandable>
</ParamField>

## Credit Cost

Dynamic — 1 credit per SIREN lookup + 100 per person with phone + 10 per person with email (contacts charged only when match `score > 40`).

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://search.leads-siren.com/enrichment-service/enrich-single \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "data": {
        "siren": "123456789"
      }
    }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://search.leads-siren.com/enrichment-service/enrich-single",
      headers={"x-api-key": "YOUR_API_KEY"},
      json={
          "data": {
              "siren": "123456789"
          }
      }
  )
  print(resp.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "siren": "123456789",
    "total_records": 5,
    "data": [
      {
        "full_name": "Jean Dupont",
        "phone": "+33 1 23 45 67 89",
        "email": "jean.dupont@example.com",
        "address": "12 Rue de Rivoli",
        "city": "Paris"
      }
    ],
    "credits_used": {
      "lookup": 5,
      "enrichment": 3,
      "total": 8
    }
  }
  ```

  ```json 400 theme={null}
  {
    "detail": "Missing siren"
  }
  ```
</ResponseExample>