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

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

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

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)

Individual role labels (for fine-grained control): "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)"
}

Getting Started

Search

Enrichment

Results & Downloads

Request Body

Credit Cost