Skip to main content
POST
/
enrichment-service
/
enrich-single
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"
    }
  }'

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())

{
  "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
  }
}

{
  "detail": "Missing siren"
}
Synchronously enrich data for a single company identified by its SIREN number. Returns the enriched data directly in the response.
Choosing between /enrich-single and /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
Matching engineLegacy enrichment engineLes 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 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.

​
Request Body

​
data
object

​
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). 
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"
    }
  }'

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())

{
  "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
  }
}

{
  "detail": "Missing siren"
}