---
title: "Fiches de 100 sociétés au plus en un appel (v1.1)"
method: POST
path: "/societes/lot"
tags: ["Sociétés"]
---

# Fiches de 100 sociétés au plus en un appel (v1.1)

`POST /societes/lot`

## Request

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

Coût : 1 unité par identifiant valide et distinct (1 au minimum) ; refus 429 si le reste du jour ne suffit pas (rien n'est consommé).

## Request body

- LotRequete
  - `identifiants` string[], required: SIREN, SIRET, TVA FR, numéros BCE (chaînes). Coût : 1 unité par identifiant valide et distinct (1 au minimum).

## Response `200`

Fiches trouvées et identifiants introuvables.

- Lot
  - `resultats` SocieteResume[], required: Dans l'ordre des identifiants reçus ; doublons servis une fois.
    - `identifiant` string, required: SIREN (FR) ou numéro BCE sur 10 chiffres (BE). Chaîne opaque.
    - `pays` 'FR' | 'BE', required
    - `siren` string, nullable, required: SIREN (FR) ; null pour la Belgique.
    - `siret_siege` string, nullable, required: SIRET du siège (FR) quand il est connu.
    - `nom` string, nullable, required: Dénomination.
    - `sigle` string, nullable, required: Sigle.
    - `forme_juridique` object, required: FR : catégorie juridique INSEE (4 chiffres), libellé null ; BE : code BCE et libellé.
      - `code` string, nullable, required: Code (null si inconnu).
      - `libelle` string, nullable, required: Libellé (null si inconnu).
    - `naf` object, required: NAF rév. 2 (FR, avec libellé) ou NACE-BEL 2025 (BE, libellé null).
      - `code` string, nullable, required: Code (null si inconnu).
      - `libelle` string, nullable, required: Libellé (null si inconnu).
    - `date_creation` string, date, nullable, required
    - `etat` 'actif' | 'cesse' | 'null', nullable, required
    - `date_cessation` string, date, nullable, required
    - `tranche_effectif` TrancheEffectif, required: Tranche d'effectif salarié (codes INSEE : NN, 00, 01, 02, 03, 11, 12, 21, 22, 31, 32, 41, 42, 51, 52, 53). annee : non stockée aujourd'hui (null).
      - `code` string, nullable, required: Code INSEE de tranche.
      - `libelle` string, nullable, required: Libellé INSEE.
      - `annee` integer, nullable, required: Année de référence (null : inconnue).
    - `capital` object, required: Capital social : aucune source à jour aujourd'hui, toujours null.
      - `montant` number, nullable, required
      - `devise` string, nullable, required: Devise ISO 4217.
    - `adresse` object, required
      - `ligne` string, nullable, required: Voie.
      - `code_postal` string, nullable, required: Code postal.
      - `ville` string, nullable, required: Commune.
      - `departement` string, nullable, required: Code INSEE du département (FR, déduit du code postal).
      - `region` string, nullable, required: Code INSEE de la région (FR) ou code ISO de la province (BE, ex. BE-VAN).
      - `pays` 'FR' | 'BE', required
    - `tva_intracom` string, nullable, required: Numéro de TVA intracommunautaire, s'il est connu (jamais calculé).
    - `site_web` string, nullable, required: Site web déclaré.
    - `dirigeant_principal` object, nullable, required: Représentant légal (FR). Personne morale : nom = dénomination, prenom = null. null si inconnu, si la société est non diffusible ou si la fiche masque ses dirigeants.
      - `nom` string, nullable, required: Nom.
      - `prenom` string, nullable, required: Premier prénom.
      - `qualite` string, nullable, required: Qualité (libellé RNE).
    - `finances` object, nullable, required: Dernier exercice déposé (FR, comptes INPI/RNE) ; null si aucun.
      - `annee` integer, required: Année de clôture.
      - `chiffre_affaires` number, nullable, required
      - `resultat_net` number, nullable, required
      - `effectif` number, nullable, required
    - `url_fiche` string, uri, nullable, required
    - `sources` object[], required: Sources utilisées ; licence lue dans le référentiel Propecto (null si non renseignée).
      - `nom` string, required
      - `licence` string, nullable, required: Licence de la source.
    - `maj_le` string, date-time, nullable, required: Dernière mise à jour de la fiche.
  - `introuvables` string[], required: Identifiants invalides ou inconnus, tels que reçus.

## Other responses

- `400`: Requête invalide (paramètre, filtre ou corps).
- `401`: Clé absente, malformée, inconnue ou révoquée.
- `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)