Top 10 French companies matching a name or identifier, with SIREN, status, city and match confidence

get/v1/recherche

Request

  • Base URL: https://api.sirenic.eu
  • URL: https://api.sirenic.eu/v1/recherche
  • Auth: one of:
    • none
    • API key in header X-Api-Key
    • HTTP bearer

Query parameters

qstring required

Company name, or a French identifier (SIREN, SIRET, VAT) — spaced or labelled ("SIREN : 552 032 534") resolves directly. Unsupported characters are stripped, not rejected; 400 only if nothing searchable is left (1-100 chars once cleaned).

Response

Top 10 matches (identity, SIREN, NAF, city, status, score_confiance 0-1). total_results counts every match, not the 10 served (tronque beyond; note_troncature when a lower bound). Best confidence under 0.5: aucune_correspondance_fiable and a bilingual note_correspondance (closest guesses, not your company). An abandoned index stage falls back to the real-time registry (data_freshness); if that fails too, the partial answer says resultats_partiels and names the stage in etages_abandonnes (always present, [] = complete). Full text: llms.txt; closed lists: GET /v1/lecture.

Changes

No recorded changes to this operation across all 1 revision of this API.