Skip to main content
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

​
data
object

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