Retrouver une association par son nom

Les noms d'associations se ressemblent : « comité des fêtes », « amicale », « les amis de… ». La réponse porte un score de confiance et le code postal du siège pour trancher entre homonymes, et distingue le fichier vivant du fichier hérité.

Voir une réponse réelle (gratuit) Obtenir le devis de /v1/associations/recherche

Ce que la route rend

Description publiée au catalogue, traduite ici en français (les agents la lisent en anglais, comme toutes nos surfaces de découverte) :

Recherche d'associations françaises (loi 1901) par nom dans le Répertoire national des associations (RNA, ministère de l'Intérieur) : similarité trigramme sur le titre normalisé, filtres facultatifs code postal, département et position (active, dissoute, supprimee), top 20 avec score_confiance et le numéro RNA à passer à /v1/association/{rna}. Associations AVEC et SANS SIREN ; le fichier hérité (aucune déclaration depuis 2009) est marqué fichier_source: import. Hors Alsace-Moselle (droit local).

Identifiant attendu

Paramètre q : le titre (ou un numéro RNA, résolu directement) ; filtres facultatifs code_postal, departement, position.

Un identifiant au mauvais format dans le chemin rend 400 et n'est pas facturé — mais il vous fait perdre un aller-retour. C'est la première cause d'appel raté sur les routes étrangères. Un paramètre de recherche, lui, est nettoyé : les caractères non pris en charge sont retirés et la requête utile est servie.

Extrait d'une réponse réellement payée

Photo datée du 06/09/2026, tronquée à un élément par tableau. Ce n'est pas une donnée en direct. L'extrait complet est servi gratuitement par la surface d'exemples, et le schéma par l'OpenAPI.

{
 "q": "croix rouge",
 "filtres": {
  "code_postal": "75",
  "departement": null,
  "position": null
 },
 "total_results": 2,
 "resultats": [
  {
   "rna": "W751004076",
   "titre": "CROIX ROUGE FRANCAISE",
   "position": "active",
   "code_postal": "75694",
   "commune": "Paris 14e",
   "date_creation": "1964-12-30",
   "siren": "775672272",
   "fichier_source": "waldec",
   "score_confiance": 1
  }
 ],
 "data_freshness": "export RNA 2026-09-01 (photo mensuelle, 5 j)"
}

Prix et facturation

Tarif : $0.002. Le montant qui fait foi est celui du devis 402 renvoyé par la route elle-même — pas ce texte, qui est dérivé de la même grille mais reste une page.

Une réponse d'erreur annule le paiement : un 400, un 404 ou un 503 n'est jamais facturé. Une panne d'une source amont ferme la route en 503 plutôt que de servir une réponse dégradée.

Appeler la route

# 1. Le devis, sans rien payer : la route répond 402 avec son montant
curl -i https://api.sirenic.eu/v1/associations/recherche

# 2. L'appel réglé — le client x402 paie le devis et rejoue la requête
npx x402-fetch https://api.sirenic.eu/v1/associations/recherche

# 3. Ou en MCP, dans Claude Code / Cursor / un agent
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

Ce que cette route ne fait pas

Un motif trop générique sur 3,5 millions de lignes peut dépasser le budget de 8 secondes : la route répond alors 503 sans rien facturer, plutôt qu'une liste tronquée vendue comme complète.

Routes voisines

/v1/association/{rna} — $0.005
/v1/recherche — $0.002

Comment on paie

Chaque route se paie à l'appel, en USDC ou EURC sur le réseau Base, par le protocole x402 : pas de compte à créer, pas de clé d'API, pas d'abonnement. Le premier appel renvoie un devis 402 que votre client règle, puis rejoue l'appel. Un appel en erreur n'est jamais facturé.

Vous préférez une facture en euros et des crédits prépayés ? C'est en préparation et nous n'annonçons pas de date tant que ce n'est pas ouvert. Écrivez à contact@sirenic.eu et vous serez prévenu à l'ouverture.

Les réponses payantes sont signées Ed25519 : vous pouvez prouver plus tard ce qui vous a été servi, et à quelle date. Le catalogue entier est lisible gratuitement dans l'OpenAPI et le llms.txt.

Un appel, de bout en bout

# Client x402 (npm) — le devis 402 est réglé et l'appel rejoué automatiquement
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Ou en MCP, dans Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

Routes utilisées et prix

Route	Prix	Exemple	Ce qu'elle rend
`/v1/associations/recherche`	$0.002	exemple gratuit	Recherche d'associations françaises (loi 1901) par nom dans le Répertoire national des associations (RNA, ministère de l'Intérieur) : similarité trigramme sur le titre normalisé, filtres facultatifs code postal, département et position (active, dissoute, supprimee), top 20 avec score_confiance et le numéro RNA à passer à /v1/association/{rna}. Associations AVEC et SANS SIREN ; le fichier hérité (aucune déclaration depuis 2009) est marqué fichier_source: import. Hors Alsace-Moselle (droit local).

Passer à l'action

Aucun compte à créer, aucune clé à demander : la première étape est gratuite et vous montre exactement ce que vous achèteriez.

Voir une réponse réelle (gratuit) Obtenir le devis de /v1/associations/recherche Être prévenu des packs en euros

Les volumes cités sur cette page ont été mesurés en base le 19/08/2026. Ce sont des photos datées, pas des compteurs en direct. · OpenAPI · llms.txt · Catalogue complet des routes et prix