> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.nogogo.fr/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nogogo.fr/_mcp/server. # Get Company Directors GET https://companies/%7Bsiren%7D/directors Liste les dirigeants publics associés à une entreprise française, selon l’offre API utilisée. Cet endpoint peut être utilisé pour l’enrichissement d’entreprise, les workflows d’analyse interne, l’enrichissement CRM, la contextualisation client/fournisseur et le support aux automatisations B2B. ## Variable de chemin | Variable | Obligatoire | Description | | --- | --- | --- | | `siren` | Oui | SIREN français de l’entreprise, composé de 9 chiffres. Exemple : `802046185` | ## Disponibilité selon l’offre Cet endpoint peut nécessiter une offre API supérieure. Si la fonctionnalité n’est pas incluse dans l’offre actuelle, l’API retourne une erreur `403 Forbidden`. ## Données retournées possibles - `siren` - `count` - `items` - `nom_complet` - `role_principal` - `type_personne` - `actif` - `mandats_actifs_count` Certains champs peuvent être `null` selon la disponibilité des données publiques. Reference: https://docs.nogogo.fr/nogogo-fr-api/directors/get-company-directors ## OpenAPI Specification ```yaml openapi: 3.1.0 info: title: collection version: 1.0.0 paths: /companies/%7Bsiren%7D/directors: get: operationId: Get Company Directors summary: Get Company Directors description: >- Liste les dirigeants publics associés à une entreprise française, selon l’offre API utilisée. Cet endpoint peut être utilisé pour l’enrichissement d’entreprise, les workflows d’analyse interne, l’enrichissement CRM, la contextualisation client/fournisseur et le support aux automatisations B2B. ## Variable de chemin | Variable | Obligatoire | Description | | --- | --- | --- | | `siren` | Oui | SIREN français de l’entreprise, composé de 9 chiffres. Exemple : `802046185` | ## Disponibilité selon l’offre Cet endpoint peut nécessiter une offre API supérieure. Si la fonctionnalité n’est pas incluse dans l’offre actuelle, l’API retourne une erreur `403 Forbidden`. ## Données retournées possibles - `siren` - `count` - `items` - `nom_complet` - `role_principal` - `type_personne` - `actif` - `mandats_actifs_count` Certains champs peuvent être `null` selon la disponibilité des données publiques. tags: - subpackage_directors parameters: - name: X-API-Key in: header required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/Directors_Get Company Directors_Response_200 servers: - url: https:/ description: https://{base_url} components: schemas: Companies7Bsiren7DDirectorsGetResponsesContentApplicationJsonSchemaItemsItems: type: object properties: id: type: string format: uuid hash_identite: type: string nom_complet: type: string nom: type: string prenoms: type: string nom_usage: description: Any type type_personne: type: string siren_personne_morale: description: Any type date_naissance: type: string format: date ville: type: string pays: type: string role_principal: type: string actif: type: boolean mandats_actifs_count: type: integer target_type: type: string target_hash_identite: type: string target_siren: description: Any type required: - id - hash_identite - nom_complet - nom - prenoms - type_personne - date_naissance - ville - pays - role_principal - actif - mandats_actifs_count - target_type - target_hash_identite title: >- Companies7Bsiren7DDirectorsGetResponsesContentApplicationJsonSchemaItemsItems Directors_Get Company Directors_Response_200: type: object properties: siren: type: string items: type: array items: $ref: >- #/components/schemas/Companies7Bsiren7DDirectorsGetResponsesContentApplicationJsonSchemaItemsItems count: type: integer required: - siren - items - count title: Directors_Get Company Directors_Response_200 securitySchemes: apiKeyAuth: type: apiKey in: header name: X-API-Key ``` ## Examples **Response** ```json { "siren": "802046185", "items": [ { "id": "f7b74b18-09ca-4438-ac90-a1e3cd17a906", "hash_identite": "ad856d2f9939be1368d248a3a148f39a85c0b6ede2a4607c48d137cad1d0bdd0", "nom_complet": "Pascale LEPOIVRE", "nom": "LEPOIVRE", "prenoms": "Pascale", "type_personne": "INDIVIDU", "date_naissance": "1966-01-01", "ville": "Paris", "pays": "FRA", "role_principal": "Président de SAS", "actif": true, "mandats_actifs_count": 0, "target_type": "director", "target_hash_identite": "ad856d2f9939be1368d248a3a148f39a85c0b6ede2a4607c48d137cad1d0bdd0" }, { "id": "4a7980c8-ce3f-4e11-8615-9a4dd1d93ad1", "hash_identite": "d6ac93dab8e794317ac2f73ef202f99e2f1429a0cdf05e9d53b5ce9b43650f33", "nom_complet": "DELOITTE & ASSOCIES", "nom": "DELOITTE & ASSOCIES", "prenoms": "string", "type_personne": "MORALE", "date_naissance": "2023-01-15", "ville": "Puteaux", "pays": "FRA", "role_principal": "Commissaire aux comptes titulaire", "actif": true, "mandats_actifs_count": 0, "target_type": "company", "target_hash_identite": "string", "siren_personne_morale": null, "target_siren": null } ], "count": 2 } ``` **SDK Code** ```python Directors_Get Company Directors_example import requests url = "https://https/companies/%7Bsiren%7D/directors" headers = {"X-API-Key": ""} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript Directors_Get Company Directors_example const url = 'https://https/companies/%7Bsiren%7D/directors'; const options = {method: 'GET', headers: {'X-API-Key': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Directors_Get Company Directors_example package main import ( "fmt" "net/http" "io" ) func main() { url := "https://https/companies/%7Bsiren%7D/directors" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("X-API-Key", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Directors_Get Company Directors_example require 'uri' require 'net/http' url = URI("https://https/companies/%7Bsiren%7D/directors") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["X-API-Key"] = '' response = http.request(request) puts response.read_body ``` ```java Directors_Get Company Directors_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://https/companies/%7Bsiren%7D/directors") .header("X-API-Key", "") .asString(); ``` ```php Directors_Get Company Directors_example request('GET', 'https://https/companies/%7Bsiren%7D/directors', [ 'headers' => [ 'X-API-Key' => '', ], ]); echo $response->getBody(); ``` ```csharp Directors_Get Company Directors_example using RestSharp; var client = new RestClient("https://https/companies/%7Bsiren%7D/directors"); var request = new RestRequest(Method.GET); request.AddHeader("X-API-Key", ""); IRestResponse response = client.Execute(request); ``` ```swift Directors_Get Company Directors_example import Foundation let headers = ["X-API-Key": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://https/companies/%7Bsiren%7D/directors")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```