curl -X POST https://search.leads-siren.com/enrichment-service/enrich \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data": {
"record_id": "665f1a2b3c4d5e6f7a8b9c0d",
"role_types": ["Executives"],
"status_filter": "current"
}
}'
import requests
resp = requests.post(
"https://search.leads-siren.com/enrichment-service/enrich",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"data": {
"record_id": "665f1a2b3c4d5e6f7a8b9c0d",
"role_types": ["Executives"],
"status_filter": "current"
}
}
)
print(resp.json())
{
"status": "success",
"message": "Enrichment task started",
"record_id": "665f1a2b3c4d5e6f7a8b9c0d"
}
{
"detail": "Insufficient credits (have 2, need 5)"
}
Enrichment
Enrich (Bulk)
POST
/
enrichment-service
/
enrich
curl -X POST https://search.leads-siren.com/enrichment-service/enrich \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data": {
"record_id": "665f1a2b3c4d5e6f7a8b9c0d",
"role_types": ["Executives"],
"status_filter": "current"
}
}'
import requests
resp = requests.post(
"https://search.leads-siren.com/enrichment-service/enrich",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"data": {
"record_id": "665f1a2b3c4d5e6f7a8b9c0d",
"role_types": ["Executives"],
"status_filter": "current"
}
}
)
print(resp.json())
{
"status": "success",
"message": "Enrichment task started",
"record_id": "665f1a2b3c4d5e6f7a8b9c0d"
}
{
"detail": "Insufficient credits (have 2, need 5)"
}
Start an asynchronous enrichment job. When used with only a
record_id (bulk-upload mode), it reads a previously uploaded CSV of SIRENs and enriches officers in the background.
Bulk-upload defaults: When no
role_types or status_filter are provided in bulk mode, the system defaults to role_types = ["Executives"] and status_filter = "current". This excludes governance/audit officers and former mandates by default — preventing irrelevant contacts (e.g. former statutory auditors) from appearing in results.Pass role_types: ["All"] and status_filter: "all" to override and include everyone.Request Body
object
Show properties
Show properties
string
required
The bulk record ID (from the upload step). The system reads the associated
input_file_path CSV.string[]
Filter officers by role before enrichment. Accepts role group names or individual labels.Role groups:
"Executives" (default), "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"Defaults to ["Executives"] in bulk mode.string
Filter by executive status.
"current" (default in bulk mode), "former", or "all".boolean
default:"false"
When
true, skips contact information lookup (email and phone).Response
The endpoint returns immediately with a confirmation — enrichment runs in the background. Use/view-enrichment-results or /generate-download-url to retrieve results once complete.
Credit Cost
Dynamic — 1 credit per SIREN lookup + 100 per person with phone + 10 per person with email (only for results with score > 40).curl -X POST https://search.leads-siren.com/enrichment-service/enrich \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data": {
"record_id": "665f1a2b3c4d5e6f7a8b9c0d",
"role_types": ["Executives"],
"status_filter": "current"
}
}'
import requests
resp = requests.post(
"https://search.leads-siren.com/enrichment-service/enrich",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"data": {
"record_id": "665f1a2b3c4d5e6f7a8b9c0d",
"role_types": ["Executives"],
"status_filter": "current"
}
}
)
print(resp.json())
{
"status": "success",
"message": "Enrichment task started",
"record_id": "665f1a2b3c4d5e6f7a8b9c0d"
}
{
"detail": "Insufficient credits (have 2, need 5)"
}