---
title: "Recherche multicritère paginée par curseur (v1.1)"
method: GET
path: "/societes/recherche"
tags: ["Sociétés"]
---

# Recherche multicritère paginée par curseur (v1.1)

`GET /societes/recherche`

## Request

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

Un filtre géographique est OBLIGATOIRE (code_postal, departement ou region) : c'est lui qui est servi par un index. naf, tranche_effectif, forme_juridique, cree_apres, cree_avant, etat et avec_site_web sont appliqués sur les sociétés de cette zone. Tri : code postal, nom. Une page peut être incomplète (budget de lecture par appel) : continuer avec curseur tant que curseur_suivant n'est pas null. Coût : 1 unité par appel.

## Query parameters

- `code_postal` string[]
- `departement` string[]
- `region` string[]
- `naf` string[]
- `tranche_effectif` string[]
- `forme_juridique` string[]
- `cree_apres` string, date
- `cree_avant` string, date
- `etat` 'actif' | 'cesse' | 'tous'
- `pays` 'FR' | 'BE'
- `avec_site_web` boolean
- `limite` integer
- `curseur` string

## Response `200`

Page de résultats.

- Recherche
  - `resultats` SocieteLigne[], required
    - `identifiant` string, required: SIREN (FR, 9 chiffres) ou numéro d'entreprise BCE (BE, 10 chiffres). À traiter comme une chaîne opaque.
    - `pays` 'FR' | 'BE', required
    - `siren` string, nullable, required: SIREN (FR) ; null pour la Belgique.
    - `nom` string, nullable, required: Dénomination.
    - `naf` object, required: Activité : NAF rév. 2 (FR, libellé INSEE) ; NACE-BEL 2025 (BE, libellé null).
      - `code` string, nullable, required: Code NAF / NACE.
      - `libelle` string, nullable, required: Libellé (FR).
    - `adresse` object, required
      - `code_postal` string, nullable, required: Code postal.
      - `ville` string, nullable, required: Commune.
      - `departement` string, nullable, required: Code INSEE du département, déduit du code postal (FR).
    - `date_creation` string, date, nullable, required
    - `etat` 'actif' | 'cesse' | 'null', 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).
    - `url_fiche` string, uri, nullable, required: Fiche publique Propecto.
  - `curseur_suivant` string, nullable, required: Curseur de la page suivante ; null quand la recherche est terminée. Une page peut être incomplète (voire vide) avec un curseur non nul : continuer tant qu'il n'est pas null.
  - `lignes_lues` integer, required: Lignes examinées pour produire la page (diagnostic).

## 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)