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"
}
Enrichment
Enrich Single
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
Use this endpoint when you need
/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 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 |
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
object
Show properties
Show properties
string
required
The 9-digit SIREN number of the company to enrich.
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.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"string
Filter by executive status.
"current" for active, "former" for former, "all" or omit for both.Credit Cost
Dynamic — 1 credit per SIREN lookup + 100 per person with phone + 10 per person with email (contacts charged only when matchscore > 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"
}