### Exemple de requête cURL pour la recherche géographique Source: https://recherche-entreprises.api.gouv.fr/docs Utilisez cet exemple pour effectuer une requête GET vers l'API afin de rechercher des entreprises par coordonnées géographiques. Spécifiez la latitude, la longitude, le rayon de recherche, et les paramètres de pagination. ```bash curl -X GET "https://recherche-entreprises.api.gouv.fr/near_point?lat=45.0428&long=-0.679&radius=5&page=1&per_page=10" -H "accept: application/json" ``` -------------------------------- ### Search Companies using cURL Source: https://recherche-entreprises.api.gouv.fr/docs Use this command to search for companies via the API. Specify the query, page number, and items per page. ```bash curl -X GET "https://recherche-entreprises.api.gouv.fr/search?q=la%20poste&page=1&per_page=1" -H "accept: application/json" ``` -------------------------------- ### Recherche géographique par coordonnées Source: https://recherche-entreprises.api.gouv.fr/docs Cet endpoint prend en paramètre une latitude (:lat) et une longitude (:long) et renvoie les unités légales et leurs établissements autour de ces coordonnées. Vous pouvez également préciser un paramètre radius en km(défaut: 5 km). ```APIDOC ## GET /near_point ### Description Cet endpoint prend en paramètre une latitude (:lat) et une longitude (:long) et renvoie les unités légales et leurs établissements autour de ces coordonnées. Vous pouvez également préciser un paramètre radius en km(défaut: 5 km). ### Method GET ### Endpoint https://recherche-entreprises.api.gouv.fr/near_point ### Parameters #### Query Parameters - **lat** (number ) - Required - Latitude de l’établissement. - **long** (number ) - Required - Longitude de l'établissement. - **radius** (number ) - Optional - Default: 5 - Radius de recherche, inférieur ou égal à 50km. - **activite_principale** (string) - Optional - Example: activite_principale=01.12Z,28.15Z - Le code NAF ou code APE, un code d'activité suivant la nomenclature de l'INSEE. Ce paramètre accepte une valeur unique ou une liste de valeurs séparées par des virgules. - **section_activite_principale** (string) - Optional - Example: section_activite_principale=A,J,U - Section de l'activité principale. Ce paramètre accepte une valeur unique ou une liste de valeurs séparées par des virgules. - **limite_matching_etablissements** (integer) - Optional - Default: 10 - Nombre d'établissements connexes inclus dans la réponse (matching_etablissements). Valeur entre 1 et 100. - **minimal** (boolean) - Optional - Enum: true, false - Permet de retourner une réponse minimale, qui exclut les champs secondaires. - **include** (string) - Optional - Example: include=siege,complements - Ce paramètre ne peut être appelé qu'avec le champ "minimal=True". Permet de ne demander que certains des champs secondaires. Valeurs possibles : complements, dirigeants, finances, matching_etablissements, siege, score. Ce paramètre accepte une valeur unique ou une liste de valeurs séparées par des virgules. - **page** (integer) - Optional - Default: 1 - Le numéro de la page à retourner. - **per_page** (integer) - Optional - Default: 10 - Le nombre de résultats par page, limité à 25. - **page_etablissements** (integer) - Optional - Default: 1 - Numéro de page pour la pagination des établissements connexes (matching_etablissements). - **sort_by_size** (boolean) - Optional - Enum: true, false - Permet de trier les résultats par taille d'entreprise (nombre d'établissements). ### Responses #### Success Response (200) La liste des unités légale et leurs établissements correspondants à la recherche. #### Error Response (400) Requête incorrecte. ### Request Example ``` curl -X GET "https://recherche-entreprises.api.gouv.fr/near_point?lat=45.0428&long=-0.679&radius=5&page=1&per_page=10" -H "accept: application/json" ``` ``` -------------------------------- ### Company Search Response Source: https://recherche-entreprises.api.gouv.fr/docs This snippet shows the structure of a successful response when searching for company information. It includes details about the company's registration, its main establishment, and a list of matching establishments. ```APIDOC ## Response Example (200 OK) ### Content Type application/json ### Body ```json { "results": [ { "siren": "356000000", "nom_complet": "la poste", "nom_raison_sociale": "LA POSTE", "sigle": null, "nombre_etablissements": 12734, "nombre_etablissements_ouverts": 9524, "siege": { "activite_principale": "53.10Z", "activite_principale_naf25": "53.10A", "activite_principale_registre_metier": null, "annee_tranche_effectif_salarie": "2020", "adresse": "19 RUE DE LA POSTE 31700 CORNEBARRIEU", "caractere_employeur": "O", "cedex": null, "code_pays_etranger": null, "code_postal": "75015", "commune": "75115", "complement_adresse": "DIRECTION GENERALE DE LA POSTE", "coordonnees": "43.292154,5.359134", "date_creation": "2019-08-24", "date_debut_activite": "2014-04-29", "date_fermeture": "2019-08-24", "date_mise_a_jour": "2023-09-21T03:34:50", "date_mise_a_jour_insee": "2023-09-21T03:34:50", "departement": "75", "distribution_speciale": null, "epci": "200058519", "est_siege": false, "etat_administratif": "A", "geo_adresse": "string", "geo_id": "string", "indice_repetition": null, "latitude": "48.83002", "libelle_cedex": null, "libelle_commune": "PARIS 15", "libelle_commune_etranger": null, "libelle_pays_etranger": null, "libelle_voie": "DU COLONEL PIERRE AVIA", "liste_enseignes": [ "LA POSTE" ], "liste_finess": [ "950000364" ], "liste_id_bio": [ "0923" ], "liste_idcc": [ "0923" ], "liste_id_organisme_formation": [ "string" ], "liste_rge": [ "4131D111", "7122D111" ], "liste_uai": [ "0170100S" ], "longitude": "2.275688", "nom_commercial": null, "numero_voie": "9", "dernier_numero_voie": "10", "region": "11", "siret": "35600000000048", "statut_diffusion_etablissement": "O", "tranche_effectif_salarie": "12", "type_voie": "RUE" }, "activite_principale": "53.10Z", "activite_principale_naf25": "53.10A", "categorie_entreprise": "GE", "caractere_employeur": "O", "annee_categorie_entreprise": "2020", "date_creation": "1991-01-01", "date_fermeture": "2019-08-24", "date_mise_a_jour": "2023-09-21T03:34:50", "date_mise_a_jour_insee": "2023-09-21T03:34:50", "date_mise_a_jour_rne": "2023-09-20T02:15:30", "dirigeants": [ { "nom": "Dupont", "prenoms": "John", "annee_de_naissance": "1964", "date_de_naissance": "1964-09", "qualite": "Directeur général", "nationalite": "Française", "type_dirigeant": "personne physique" } ], "etat_administratif": "A", "nature_juridique": "5510", "section_activite_principale": "H", "tranche_effectif_salarie": "53", "annee_tranche_effectif_salarie": "2020", "statut_diffusion": "O", "matching_etablissements": [ { "activite_principale": "53.10Z", "activite_principale_naf25": "53.10A", "ancien_siege": false, "annee_tranche_effectif_salarie": "2020", "adresse": "19 RUE DE LA POSTE 31700 CORNEBARRIEU", "caractere_employeur": "O", "code_postal": "75015", "commune": "75115", "date_creation": "2019-08-24", "date_debut_activite": "2014-04-29", "date_fermeture": "2019-08-24", "epci": "200058519", "est_siege": false, "etat_administratif": "A", "geo_id": "string", "latitude": "48.83002", "libelle_commune": "PARIS 15", "liste_enseignes": [ "LA POSTE" ], "liste_finess": [ "950000364" ], "liste_id_bio": [ "0923" ], "liste_idcc": [ "0923" ], "liste_id_organisme_formation": [ "string" ], "liste_rge": [ "4131D111", "7122D111" ], "liste_uai": [ "0170100S" ], "longitude": "2.275688", "nom_commercial": null, "region": "11", "siret": "35600000000048", "statut_diffusion_etablissement": "O", "tranche_effectif_salarie": "12" } ], "finances": { "annee_existence1": { "ca": 0, "resultat_net": 0 }, "annee_existence2": { "ca": 0 } } } ] } ``` ``` -------------------------------- ### Query Parameters for Company Search Source: https://recherche-entreprises.api.gouv.fr/docs This section details the query parameters available for searching and filtering company information. These parameters can be used to refine search results based on various attributes of companies and their associated entities. ```APIDOC ## Query Parameters ### Parameters - **etat_administratif** (string Enum: "A" "C") - Required/Optional - Administrative status of the legal unit. "A" for Active, "C" for Ceased. - **id_convention_collective** (string) - Example: id_convention_collective=1090 - Collective agreement ID of an establishment of a company. - **id_finess** (string) - Example: id_finess=010003853 - Geographical FINESS ID of an establishment (9 digits). This search only queries Geographical FINESS of establishments. - **id_rge** (string) - Example: id_rge=8611M10D109 - RGE (Reconnues Garantes de l'Environnement) ID of an establishment of a company. - **id_uai** (string) - Example: id_uai=0022004T - UAI ID of an establishment of a company. - **nature_juridique** (string) - Example: nature_juridique=7344,6544 - Legal category of the legal unit. This parameter accepts a single value or a list of values separated by commas. - **section_activite_principale** (string) - Example: section_activite_principale=A,J,U - Main activity section: `A` - Agriculture, forestry and fishing, `B` - Mining and quarrying, `C` - Manufacturing, `D` - Production and distribution of electricity, gas, steam and air conditioning, `E` - Water supply; sewerage, waste management and remediation activities, `F` - Construction, `G` - Wholesale and retail trade; repair of motor vehicles and motorcycles, `H` - Transportation and storage, `I` - Accommodation and food service activities, `J` - Information and communication, `K` - Financial and insurance activities, `L` - Real estate activities, `M` - Professional, scientific and technical activities, `N` - Administrative and support service activities, `O` - Public administration and defence; compulsory social security, `P` - Education, `Q` - Human health and social work activities, `R` - Arts, entertainment and recreation, `S` - Other service activities, `T` - Activities of households as employers; undifferentiated goods- and services-producing activities of households for own use, `U` - Activities of extraterritorial organisations and bodies. This parameter accepts a single value or a list of values separated by commas. - **tranche_effectif_salarie** (string) - Example: tranche_effectif_salarie=NN,00,01 - Employee headcount range of the company. This parameter accepts a single value or a list of values separated by commas. - **nom_personne** (string) - Example: nom_personne=Dupont - Name of a stakeholder in the company (director or elected official). - **prenoms_personne** (string) - Example: prenoms_personne=Monsieur - First name(s) of a stakeholder in the company (director or elected official). - **date_naissance_personne_min** (string ) - Example: date_naissance_personne_min=1960-01-01 - Minimum value of the birth date of a stakeholder in the company (director or elected official). - **date_naissance_personne_max** (string ) - Example: date_naissance_personne_max=1990-01-01 - Maximum value of the birth date of a stakeholder in the company (director or elected official). - **type_personne** (string Enum: "dirigeant" "elu") - Type of the company stakeholder, director or elected official. - **ca_min** (integer) - Example: ca_min=100000 - Minimum value of the company's turnover. - **ca_max** (integer) - Example: ca_max=100000 - Maximum value of the company's turnover. - **resultat_net_min** (integer) - Example: resultat_net_min=100000 - Minimum value of the company's net income. - **resultat_net_max** (integer) - Example: resultat_net_max=100000 - Maximum value of the company's net income. - **limite_matching_etablissements** (integer) - Default: 10 - Number of related establishments included in the response (matching_etablissements). Value between 1 and 100. - **minimal** (boolean Enum: true false) - Allows returning a minimal response, which excludes secondary fields. See "include" for more details. - **include** (string) - Example: include= siege,complements - ATTENTION: This parameter can only be called with the field "minimal=True". Allows requesting only certain secondary fields. Possible values: complements, dirigeants, finances, matching_etablissements, siege, score. By default, all fields are included except the score. This parameter accepts a single value or a list of values separated by commas. - **page** (integer) - Default: 1 - The page number to return. - **per_page** (integer) - Default: 10 - The number of results per page, limited to 25. - **page_etablissements** (integer) - Default: 1 - Page number for pagination of related establishments (matching_etablissements). - **sort_by_size** (boolean Enum: true false) - Allows sorting results by company size (number of establishments). ``` -------------------------------- ### Search Companies Source: https://recherche-entreprises.api.gouv.fr/docs Allows searching for companies using various query parameters. Returns a list of legal units and their corresponding establishments. ```APIDOC ## GET /search ### Description Searches for companies and returns a list of legal units and their establishments. ### Method GET ### Endpoint https://recherche-entreprises.api.gouv.fr/search ### Query Parameters - **q** (string) - Required - The search query. - **page** (integer) - Optional - The page number for pagination. - **per_page** (integer) - Optional - The number of results per page. ### Response #### Success Response (200) - **data** (array) - A list of legal units and their establishments matching the search criteria. #### Response Example { "example": "[ \n {\n \"unite_legale\": { ... },\n \"etablissements\": [ ... ]\n }\n]" } ### Error Handling #### Bad Request (400) - Indicates an issue with the request parameters. ``` -------------------------------- ### Search Companies Source: https://recherche-entreprises.api.gouv.fr/docs This endpoint allows you to search for companies using a variety of query parameters. You can filter by textual search terms, activity codes, company category, geographical location, and specific certifications or labels. ```APIDOC ## GET /search/companies ### Description Allows searching for companies based on various criteria. ### Method GET ### Endpoint /search/companies ### Parameters #### Query Parameters - **q** (string) - Required - Textual search terms (name, address, directors, elected officials) or direct search (SIREN, SIRET). - **activite_principale** (string) - Optional - NAF or APE code(s) (e.g., "01.12Z,28.15Z"). Applies to the legal unit only. - **categorie_entreprise** (string) - Optional - Company category (e.g., "PME", "ETI", "GE"). Accepts a single value or a comma-separated list. - **code_collectivite_territoriale** (string) - Optional - Code associated with a territorial collectivity (e.g., INSEE code for Commune, SIREN for EPCI). - **convention_collective_renseignee** (boolean) - Optional - Filter for companies with at least one establishment where the collective agreement is specified (true/false). - **code_postal** (string) - Optional - 5-digit postal code(s) (e.g., "38540,38189"). Filters on establishments. - **code_commune** (string) - Optional - 5-character commune code (INSEE) (e.g., "01247,01111"). Filters on establishments. - **departement** (string) - Optional - Department code(s) (e.g., "02,89"). Filters on establishments. - **region** (string) - Optional - Region code(s) (e.g., "11,76"). Filters on establishments. - **epci** (string) - Optional - List of valid EPCI codes (e.g., "200058519,248100737"). Filters on establishments. - **egapro_renseignee** (boolean) - Optional - Filter for companies with a renseigné Egapro index (true/false). - **est_achats_responsables** (boolean) - Optional - Filter for companies with the "Relations Fournisseurs et Achats Responsables" (RFAR) label (true/false). - **est_alim_confiance** (boolean) - Optional - Filter for companies with at least one establishment with a "Alim'Confiance" sanitary control result (true/false). - **est_association** (boolean) - Optional - Filter for companies with an association identifier or a legal nature mentioning "association" (true/false). - **est_bio** (boolean) - Optional - Filter for companies with an establishment certified by Agence Bio (true/false). - **est_collectivite_territoriale** (boolean) - Optional - Filter for territorial collectivities only (true/false). - **est_entrepreneur_individuel** (boolean) - Optional - Filter for individual entrepreneurs only (true/false). - **est_entrepreneur_spectacle** (boolean) - Optional - Filter for companies with a spectacle entrepreneur license (true/false). - **est_ess** (boolean) - Optional - Filter for companies belonging to the social and solidarity economy sector (true/false). - **est_finess** (boolean) - Optional - Filter for companies in the health and social sector (FINESS) (true/false). - **est_organisme_formation** (boolean) - Optional - Filter for companies with a training organization establishment (true/false). - **est_patrimoine_vivant** (boolean) - Optional - Filter for companies with the "Entreprise du Patrimoine Vivant" (EPV) label (true/false). - **est_qualiopi** (boolean) - Optional - Filter for companies with "Qualiopi" certification (true/false). - **est_rge** (boolean) - Optional - Filter for companies recognized as "Garant de l'Environnement" (RGE) (true/false). - **est_siae** (boolean) - Optional - Filter for insertion structures for economic activity (SIAE) (true/false). - **est_service_public** (boolean) - Optional - Filter for structures recognized as public administration (true/false). - **est_l100_3** (boolean) - Optional - Filter for administrations as defined in Article L. 100-3 of the CRPA (true/false). - **est_societe_mission** (boolean) - Optional - Filter for companies that are "sociétés à mission" (true/false). - **est_uai** (boolean) - Optional - Filter for companies with a UAI (Unité Administrative Immatriculée) establishment (true/false). ### Request Example ```json { "query": "Example Company", "activite_principale": "62.01Z", "code_postal": "75001,75002" } ``` ### Response #### Success Response (200) - **Companies** (array) - List of companies matching the search criteria. - **nom** (string) - Company name. - **siren** (string) - SIREN number. - **adresse** (string) - Company address. - ... (other company details) #### Response Example ```json { "companies": [ { "nom": "Example Company SARL", "siren": "123456789", "adresse": "1 Rue de Exemple, 75001 Paris" } ] } ``` ``` -------------------------------- ### Textual Search Source: https://recherche-entreprises.api.gouv.fr/docs This endpoint allows you to retrieve legal entities and their establishments by searching based on the name, address, directors, and elected officials. You can also search directly by SIREN or SIRET number. ```APIDOC ## GET /search ### Description This endpoint allows you to retrieve legal entities and their establishments by searching based on the name, address, directors, and elected officials. You can also search directly by SIREN or SIRET number. There are two search modes depending on the value of the `q` parameter: * **Classic textual search** (name, address, directors, elected officials): all optional filters (`code_commune`, `code_postal`, `departement`, `region`, `epci`, etc.) are applied in combination with the search. * **Direct search by SIREN or SIRET**: if `q` contains exactly 9 digits (SIREN) or 14 digits (SIRET), the API performs a direct search and **ignores all other filters**. Combining a SIREN or SIRET with geographic or thematic filters will not produce an error, but these filters will be silently ignored. ### Method GET ### Endpoint https://recherche-entreprises.api.gouv.fr/search ### Parameters #### Query Parameters - **q** (string) - Required - The search query. Can be a name, address, director name, or SIREN/SIRET. - **code_commune** (string) - Optional - Filter by commune code. - **code_postal** (string) - Optional - Filter by postal code. - **departement** (string) - Optional - Filter by department code. - **region** (string) - Optional - Filter by region code. - **epci** (string) - Optional - Filter by EPCI code. ### Request Example ```http GET /search?q=NomEntreprise&code_postal=75001 ``` ### Response #### Success Response (200) - **results** (array) - List of matching companies or establishments. - **total_results** (integer) - Total number of results found. #### Response Example ```json { "results": [ { "siren": "123456789", "nic": "00001", "denomination": "Nom Entreprise", "adresse": "1 Rue de la Paix, 75001 Paris" } ], "total_results": 1 } ``` ``` -------------------------------- ### Successful Company Response (200) Source: https://recherche-entreprises.api.gouv.fr/docs This JSON object represents a successful response for a company query. It includes detailed information about the company and its establishments. ```json { "results": [ { "siren": "356000000", "nom_complet": "la poste", "nom_raison_sociale": "LA POSTE", "sigle": null, "nombre_etablissements": 12734, "nombre_etablissements_ouverts": 9524, "siege": { "activite_principale": "53.10Z", "activite_principale_naf25": "53.10A", "activite_principale_registre_metier": null, "annee_tranche_effectif_salarie": "2020", "adresse": "19 RUE DE LA POSTE 31700 CORNEBARRIEU", "caractere_employeur": "O", "cedex": null, "code_pays_etranger": null, "code_postal": "75015", "commune": "75115", "complement_adresse": "DIRECTION GENERALE DE LA POSTE", "coordonnees": "43.292154,5.359134", "date_creation": "2019-08-24", "date_debut_activite": "2014-04-29", "date_fermeture": "2019-08-24", "date_mise_a_jour": "2023-09-21T03:34:50", "date_mise_a_jour_insee": "2023-09-21T03:34:50", "departement": "75", "distribution_speciale": null, "epci": "200058519", "est_siege": false, "etat_administratif": "A", "geo_adresse": "string", "geo_id": "string", "indice_repetition": null, "latitude": "48.83002", "libelle_cedex": null, "libelle_commune": "PARIS 15", "libelle_commune_etranger": null, "libelle_pays_etranger": null, "libelle_voie": "DU COLONEL PIERRE AVIA", "liste_enseignes": [ "LA POSTE" ], "liste_finess": [ "950000364" ], "liste_id_bio": [ "0923" ], "liste_idcc": [ "0923" ], "liste_id_organisme_formation": [ "string" ], "liste_rge": [ "4131D111", "7122D111" ], "liste_uai": [ "0170100S" ], "longitude": "2.275688", "nom_commercial": null, "numero_voie": "9", "dernier_numero_voie": "10", "region": "11", "siret": "35600000000048", "statut_diffusion_etablissement": "O", "tranche_effectif_salarie": "12", "type_voie": "RUE" }, "activite_principale": "53.10Z", "activite_principale_naf25": "53.10A", "categorie_entreprise": "GE", "caractere_employeur": "O", "annee_categorie_entreprise": "2020", "date_creation": "1991-01-01", "date_fermeture": "2019-08-24", "date_mise_a_jour": "2023-09-21T03:34:50", "date_mise_a_jour_insee": "2023-09-21T03:34:50", "date_mise_a_jour_rne": "2023-09-20T02:15:30", "dirigeants": [ { "nom": "Dupont", "prenoms": "John", "annee_de_naissance": "1964", "date_de_naissance": "1964-09", "qualite": "Directeur général", "nationalite": "Française", "type_dirigeant": "personne physique" } ], "etat_administratif": "A", "nature_juridique": "5510", "section_activite_principale": "H", "tranche_effectif_salarie": "53", "annee_tranche_effectif_salarie": "2020", "statut_diffusion": "O", "matching_etablissements": [ { "activite_principale": "53.10Z", "activite_principale_naf25": "53.10A", "ancien_siege": false, "annee_tranche_effectif_salarie": "2020", "adresse": "19 RUE DE LA POSTE 31700 CORNEBARRIEU", "caractere_employeur": "O", "code_postal": "75015", "commune": "75115", "date_creation": "2019-08-24", "date_debut_activite": "2014-04-29", "date_fermeture": "2019-08-24", "epci": "200058519", "est_siege": false, "etat_administratif": "A", "geo_id": "string", "latitude": "48.83002", "libelle_commune": "PARIS 15", "liste_enseignes": [ "LA POSTE" ], "liste_finess": [ "950000364" ], "liste_id_bio": [ "0923" ], "liste_idcc": [ "0923" ], "liste_id_organisme_formation": [ "string" ], "liste_rge": [ "4131D111", "7122D111" ], "liste_uai": [ "0170100S" ], "longitude": "2.275688", "nom_commercial": null, "region": "11", "siret": "35600000000048", "statut_diffusion_etablissement": "O", "tranche_effectif_salarie": "12" } ], "finances": { "annee_existence1": { "ca": 0, "resultat_net": 0 }, "annee_existence2": { "ca": 0 } } } ] } ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.