curl -X POST https://search.leads-siren.com/enrichment-service/search_executives \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data": {
"siren_numbers": ["123456789", "987654321"],
"role_types": ["Président", "Directeur général", "Gérant"],
"status_filter": "current",
"page": 1
}
}'
import requests
resp = requests.post(
"https://search.leads-siren.com/enrichment-service/search_executives",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"data": {
"siren_numbers": ["123456789", "987654321"],
"role_types": ["Président", "Directeur général", "Gérant"],
"status_filter": "current",
"page": 1
}
}
)
print(resp.json())
{
"total": 36,
"page": 1,
"per_page": 20,
"total_pages": 2,
"people": [
{
"nom_complet": "Jean Dupont",
"qualite": "Président",
"status": "current",
"date_de_naissance": "1975-03-15",
"entreprises": [ ... ]
}
]
}
{
"detail": "Insufficient credits (have 2, need 5)"
}
Search
Search Executives
POST
/
enrichment-service
/
search_executives
curl -X POST https://search.leads-siren.com/enrichment-service/search_executives \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data": {
"siren_numbers": ["123456789", "987654321"],
"role_types": ["Président", "Directeur général", "Gérant"],
"status_filter": "current",
"page": 1
}
}'
import requests
resp = requests.post(
"https://search.leads-siren.com/enrichment-service/search_executives",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"data": {
"siren_numbers": ["123456789", "987654321"],
"role_types": ["Président", "Directeur général", "Gérant"],
"status_filter": "current",
"page": 1
}
}
)
print(resp.json())
{
"total": 36,
"page": 1,
"per_page": 20,
"total_pages": 2,
"people": [
{
"nom_complet": "Jean Dupont",
"qualite": "Président",
"status": "current",
"date_de_naissance": "1975-03-15",
"entreprises": [ ... ]
}
]
}
{
"detail": "Insufficient credits (have 2, need 5)"
}
Look up executives (dirigeants) for one or more companies. Provide SIREN numbers directly, or supply company search filters to resolve them automatically. You must provide either
siren_numbers or filters + limit — not both.
Request Body
object
Show properties
Show properties
string[]
List of SIREN numbers to look up executives for.
object
Company search filters. Used with
limit to first search companies, then fetch their executives. All filter fields are optional.Show filter fields
Show filter fields
string[]
Free-text search terms (e.g. company name).
string[]
NAF/APE activity codes (e.g.
["62.01Z", "62.02A"]).string
Administrative status.
"A" for active, "C" for closed.string[]
Employee count ranges. Allowed values:
"0", "1-9", "10-49", "50-199", "200-499", "500+".string[]
French department codes (e.g.
["75", "92", "93"]).string
French region code (e.g.
"11" for Ile-de-France).string[]
Postal codes (e.g.
["75001", "75002"]).string[]
Legal form categories. Allowed values:
"Entreprises individuelles", "Sociétés commerciales", "Sociétés civiles", "Associations", "Autres".integer
Maximum number of companies to search when using
filters.string[]
Filter executives by role. Accepts role group names or individual Pappers role labels (or a mix of both).Role groups (recommended for UI filters):
"Executives"— Président, Directeur général, DGD, Gérant, PCA, Membre du directoire, Chef d’entreprise"Governance & Audit"— Administrateur, Membre du conseil de surveillance, Commissaire aux comptes (titulaire + suppléant)"Shareholders & Other"— Membre, Associé indéfiniment responsable, Autre"Liquidator"— Liquidateur"All"— no filtering (returns every role)
"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"If omitted, all roles are returned.string
Filter by executive status.
"current" for active executives, "former" for former executives, "all" or omit for both.integer
default:"1"
Page number for paginated results. Each page returns up to 20 executives. Defaults to
1.Credit Cost
1 credit per company/SIREN queried. Credits are charged on the full result set on the first page request — subsequent pages for the same query cost nothing extra.curl -X POST https://search.leads-siren.com/enrichment-service/search_executives \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data": {
"siren_numbers": ["123456789", "987654321"],
"role_types": ["Président", "Directeur général", "Gérant"],
"status_filter": "current",
"page": 1
}
}'
import requests
resp = requests.post(
"https://search.leads-siren.com/enrichment-service/search_executives",
headers={"x-api-key": "YOUR_API_KEY"},
json={
"data": {
"siren_numbers": ["123456789", "987654321"],
"role_types": ["Président", "Directeur général", "Gérant"],
"status_filter": "current",
"page": 1
}
}
)
print(resp.json())
{
"total": 36,
"page": 1,
"per_page": 20,
"total_pages": 2,
"people": [
{
"nom_complet": "Jean Dupont",
"qualite": "Président",
"status": "current",
"date_de_naissance": "1975-03-15",
"entreprises": [ ... ]
}
]
}
{
"detail": "Insufficient credits (have 2, need 5)"
}