# entreprises.get

Consulter une entreprise par SIREN ou un établissement par SIRET. Enveloppe results contenant une fiche.

POST `/api/mcp/v1/entreprises.get` · contrat 1.0.0 · OAuth `mcp:read` · offre payante : false.

Outil MCP : `prescriptio_entreprises` ; même handler métier.

## Entrée

```json
{
  "additionalProperties": false,
  "oneOf": [
    {
      "required": [
        "siren"
      ]
    },
    {
      "required": [
        "siret"
      ]
    }
  ],
  "properties": {
    "siren": {
      "description": "SIREN 9 chiffres : fiche complete de l'entreprise (identite, NAF, effectif, forme juridique, creation, dirigeants, evolution du chiffre d'affaires).",
      "pattern": "^\\d{9}$",
      "type": "string"
    },
    "siret": {
      "description": "SIRET 14 chiffres : fiche d'un etablissement precis.",
      "pattern": "^\\d{14}$",
      "type": "string"
    }
  },
  "type": "object"
}
```

## Exemple synthétique

```json
{
  "siren": "000000001"
}
```

## Sortie

```json
{
  "properties": {
    "_meta": {
      "type": "object"
    },
    "next_cursor": {
      "description": "À repasser tel quel pour la page suivante ; null s'il n'y en a plus.",
      "type": [
        "string",
        "null"
      ]
    },
    "results": {
      "description": "Résultats de la page courante.",
      "items": {
        "properties": {
          "fields": {
            "properties": {
              "adresse": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "capital_social_eur": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "categorie": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "code_naf": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "code_postal": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "date_creation": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "departement": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "dirigeants": {
                "items": {
                  "type": "object"
                },
                "type": "array"
              },
              "effectif": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "est_rge": {
                "type": "boolean"
              },
              "etat": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "evolution_ca": {
                "items": {
                  "type": "object"
                },
                "type": "array"
              },
              "forme_juridique": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "libelle_naf": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "nom_commercial": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "nombre_certifications_actives": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "raison_sociale": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "raison_sociale_connue": {
                "type": "boolean"
              },
              "rge_date_fin": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "rge_domaines": {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "siren": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "siret": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "ville": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "type": "object"
          },
          "id": {
            "description": "Identifiant à citer (SIREN/SIRET, marche_id, réf DECP).",
            "type": "string"
          },
          "resume": {
            "type": "string"
          },
          "titre": {
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "total_estimated": {
      "description": "Total connu ou estimation signalée par la source ; null si le total est inconnu. Ne jamais extrapoler depuis la taille de la page.",
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "results"
  ],
  "type": "object"
}
```

[Authentification, quotas, pagination et erreurs](/docs/reference/concepts.md). Les propriétés additionnelles des résultats historiques restent autorisées ; ce schéma n'invente pas les champs manquants.
