---
title: "Fiche analytique d'une société française (v1.0)"
method: GET
path: "/societes/{siren}"
tags: ["Sociétés"]
---

# Fiche analytique d'une société française (v1.0)

`GET /societes/{siren}`

## Request

- Base URL: `https://api.propecto.eu/v1`
- URL: `https://api.propecto.eu/v1/societes/{siren}`
- Auth: one of:
  - API key in header `x-api-cle`
  - HTTP bearer

Un identifiant dont la clé de contrôle est invalide (SIREN ou numéro BCE) est refusé 404 « introuvable », sans consommer de quota.

## Path parameters

- `siren` string, required

## Response `200`

Fiche (trouve = false si inconnue).

- AnalyseSociete: Fiche analytique v1.0 (fs_analyse_societe) : société, historique financier, secteur, attributaires de marchés.
  - `siren` string
  - `trouve` boolean
  - `note` string: Présent quand trouve = false.
  - `societe` object: Colonnes de la fiche société (champs masqués retirés).
  - `historique` object[]
    - `annee` integer
    - `ca` number, nullable
    - `resultat` number, nullable
    - `effectif` number, nullable
    - `capitaux_propres` number, nullable
    - `total_bilan` number, nullable
  - `secteur` object: Panel comparable (médianes) ou note.
  - `attributaires` object[]
  - `attributaires_portee` string
  - `sante_financiere` object: Renvoi vers les jauges financières.
  - `calcule_le` string, date-time

## Other responses

- `401`: Clé absente, malformée, inconnue ou révoquée.
- `404`: Introuvable.
- `405`: Méthode non autorisée.
- `429`: Quota journalier atteint ou insuffisant.
- `500`: Vérification de la clé impossible.
- `502`: Échec de la requête à la base.

---

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