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).
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
Association title, or an RNA number (resolved directly)
Postal code or prefix
01-95, 2A, 2B or 971-989
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.