Search French associations by name (RNA)

Search French associations (loi 1901) by name in the Répertoire national des associations (RNA, Ministry of the Interior): normalised title prefix, then trigram similarity, optional postal-code, department and position filters, top 20 with score_confiance and the RNA number to use on /v1/association/{rna}. Associations with AND without a SIREN; legacy file (no declaration since 2009) flagged fichier_source: import. Excludes Alsace-Moselle (local law).

get/v1/associations/recherche

Request

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

Query parameters

qstring required

Association title, or an RNA number (resolved directly)

code_postalstring

Postal code or prefix

departementstring

01-95, 2A, 2B or 971-989

position'active' | 'dissoute' | 'supprimee'

Position filter

Response

Up to 20 matches: rna, titre, position, code_postal, commune, date_creation, siren (when confirmed), fichier_source, score_confiance (0-1), correspondance (the ORDER before the score): identifiant (RNA number typed), debut_du_titre (title starts with q), then mots_similaires (fuzzy: typos, inverted words; only if the first stage returns under 20). Filters apply first; each stage compares at most 3000 filtered titles, newest first at debut_du_titre (undated last, then RNA number), closest first at mots_similaires (trigram distance). total_results counts the typed RNA number (served even if filtered out) and the filtered titles of the stages run, not the 20 served (listes_bornees); a lower bound if a stage finds more or is abandoned, named with its reason in note_completude (resultats_partiels: true). etages_abandonnes (always present, [] = none) names a stage over the 6s call budget or failing in the database, answer still served. No match = 200, empty list.

Changes

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