---
title: "Fiche d'une entreprise française (SIREN, SIRET, TVA, nom ou dirigeant)"
method: GET
path: "/api/company/lookup"
tags: ["Company lookup"]
---

# Fiche d'une entreprise française (SIREN, SIRET, TVA, nom ou dirigeant)

`GET /api/company/lookup`

## Request

- Base URL: `https://outsend.xyz`
- URL: `https://outsend.xyz/api/company/lookup`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Identité légale d'une entreprise pour préremplir un formulaire : raison
sociale, forme juridique, NAF, siège, TVA intracommunautaire (statut VIES),
dirigeant, contrôles de clé.

## Query parameters

- `q` string, nullable: SIREN (9 chiffres), SIRET (14 chiffres), numéro de TVA FR (FR + 11 chiffres) ou nom d'entreprise. Obligatoire sans `nom`
- `nom` string, nullable: À la place de `q` : nom d'une personne, pour obtenir les entreprises dont elle est entrepreneur individuel ou dirigeant
- `prenom` string, nullable: Prénom de la personne (avec `nom`)
- `naf` string, nullable: Filtre d'activité : un ou plusieurs codes NAF séparés par des virgules (ex. 66.22Z), pour les recherches par nom et par personne
- `naissance` string, nullable: Recherche par personne : année et mois de naissance de la personne (AAAA-MM) ou année seule (AAAA), pour départager les homonymes. La réponse ne donne jamais la date, seulement `naissance_concorde`
- `limit` integer: Nombre maximum de candidats (recherche par nom ou par personne)

## Response `200`

Successful Response

- CompanyLookupResponse
  - `requete` string, required
  - `type_requete` 'siren' | 'siret' | 'nom' | 'personne', required
  - `nb_resultats` integer, required
  - `resultats` Entreprise[], required
    - `siren` string, required: SIREN, 9 chiffres
    - `siret_siege` string, nullable: SIRET du siège, 14 chiffres
    - `raison_sociale` string, required: Dénomination, ou « prénom nom » pour une personne physique
    - `sigle` string, nullable
    - `forme_juridique` EntrepriseCode, required
      - `code` string, nullable: Code officiel INSEE
      - `libelle` string, nullable: Libellé du code
    - `naf` EntrepriseCode, required
      - `code` string, nullable: Code officiel INSEE
      - `libelle` string, nullable: Libellé du code
    - `date_creation` string, nullable: AAAA-MM-JJ
    - `etat` 'actif' | 'ferme', required
    - `adresse_siege` EntrepriseAdresse
      - `rue` string, nullable: Numéro et voie, tels que le registre les donne
      - `code_postal` string, nullable
      - `ville` string, nullable
      - `code_commune` string, nullable: Code officiel géographique (INSEE) de la commune
    - `etablissement` EntrepriseEtablissement
      - `siret` string, required
      - `est_siege` boolean, required
      - `rue` string, nullable
      - `code_postal` string, nullable
      - `ville` string, nullable
    - `dirigeant` EntrepriseDirigeant
      - `type` 'personne_physique' | 'personne_morale', required
      - `nom` string, nullable: Nom (personne physique) ou dénomination (personne morale)
      - `prenoms` string, nullable
      - `qualite` string, nullable: Ex. « Président de SAS », « Entrepreneur individuel »
    - `naissance_concorde` boolean, nullable: Recherche par personne avec `naissance` : true si la naissance connue du registre pour ce dirigeant concorde, false si elle diffère, null si le registre ne la donne pas. Toujours null sans le paramètre `naissance`
    - `tva_intracom` string, required: Numéro de TVA intracommunautaire calculé depuis le SIREN
    - `tva_statut` 'valide' | 'non_attribue' | 'inconnu', required: valide = confirmé par VIES ; non_attribue = VIES répond qu'il n'est pas attribué ; inconnu = VIES indisponible, réessayer (ne jamais le considérer valide)
    - `tva_verifiee_le` string, nullable: Horodatage ISO de la réponse VIES
    - `controles` EntrepriseControles, required
      - `siren_luhn` boolean, required: Clé de Luhn du SIREN correcte
      - `siret_siege_luhn` boolean, nullable: Clé du SIRET du siège correcte (exception La Poste incluse) ; null sans siège connu

## Other responses

- `400`: Requête invalide
- `422`: Validation Error
- `429`: Trop de requêtes (en-tête Retry-After)

---

[API](https://skmtc.dev/outsend/apis/outsend-api.md) · [All operations](https://skmtc.dev/outsend/apis/outsend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outsend/apis/outsend-api/revisions/39db3c6f886a?raw)