---
title: "Rechercher des sociétés par nom ou numéro (v1.0)"
method: GET
path: "/societes"
tags: ["Sociétés"]
---

# Rechercher des sociétés par nom ou numéro (v1.0)

`GET /societes`

## Request

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

## Query parameters

- `q` string, required
- `pays` string
- `limite` integer

## Response `200`

Suggestions (au plus 20).

- SuggestionsSocietes
  - `resultats` object
    - `items` object[]
      - `pays` string
      - `reg_id` string
      - `nom` string, nullable: Dénomination.
      - `ville` string, nullable: Commune.
      - `actif` boolean, nullable
      - `tva` string, nullable: TVA.
    - `voie` 'numero' | 'nom' | 'trop_court'

## Other responses

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