sirenic

Associations loi 1901

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é.

https://api.sirenic.eu/v1OpenAPI 3.1llms.txt

GET/v1/associations/recherche

Prix
0,002 €
Quota gratuit
Inclus
Famille
Associations loi 1901
Paramètres
ParamètreOùExemple
qrequête · obligatoirecroix rouge
code_postalrequête · facultatif75
departementrequête · facultatifsans exemple
positionrequête · facultatifsans exemple

Ce qui est facturé

  • 200Réponse signée Ed25519, débitée au prix de la route
  • 402Devis x402 signé, rien n'est débité
  • 4xxIdentifiant inconnu ou invalide, jamais facturé
  • 5xxSource amont indisponible, ou total compté sous la liste lue (compte_incoherent), jamais facturé

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) : début du titre normalisé, puis similarité trigramme, filtres facultatifs code postal, département et position, top 20 avec score_confiance et le numéro RNA à passer à /v1/association/{rna}. Associations AVEC et SANS SIREN ; fichier hérité (aucune déclaration depuis 2009) 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.

Prix et facturation

Tarif : 0,002 €, débité en crédits (1 crédit = 1 €) ; en x402, le même montant se règle en USDC ou en EURC. 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.

Ce que cette route ne fait pas

Elle ne garantit pas de voir toutes les associations qui correspondent dès qu'une de ses deux étapes trouve plus de 3000 titres qui passent les filtres. La recherche a un budget de 6 secondes par appel, pour ses deux étapes (titres qui commencent par la requête, puis titres semblables). Chaque étape applique d'abord les filtres (code postal, département, position), puis compare au plus 3000 des titres qui les passent : les plus récemment créés d'abord pour les titres qui commencent par la requête (date de création décroissante, dates inconnues en dernier), les plus proches d'abord pour les titres semblables (distance trigramme). Quand une étape en trouve plus, la réponse, servie en 200 au prix de la route, le dit en nommant l'étape (resultats_partiels, note_completude). Une étape qui ne tient pas dans le budget, ou qui échoue côté base, est nommée dans etages_abandonnes ; la route ne répond 503 (recherche_associations_indisponible), sans rien facturer, que si une étape a été abandonnée et qu'aucun résultat n'a été trouvé. Le total servi (total_results, et nombre_total de listes_bornees.resultats) se compte avant la coupe aux 20 résultats servis : le numéro RNA saisi dans q, servi et compté même s'il ne passe pas les filtres, puis les titres qui passent les filtres dans chaque étape lancée, chacun une fois (l'étape des titres semblables ne tourne que si la première rend moins de 20 titres) ; c'est une borne basse (total_borne_basse) quand une étape en trouve plus de 3000 ou est abandonnée.

Routes voisines

  • /v1/association/{rna} : 0,005 €
  • /v1/recherche : 0,002 €

Comment on paie

Chaque route se paie à l'appel, de deux façons, sans abonnement : en x402, en USDC ou EURC sur le réseau Base, sans compte ni clé d'API ; ou avec la clé d'API d'un compte, qui ouvre le quota gratuit. En x402, le premier appel renvoie un devis 402 que votre client règle, puis rejoue l'appel. Un appel en erreur n'est jamais facturé.

Ouvert aujourd'hui : 150 appels gratuits par mois avec un compte, dans la limite de 2 € de valeur, sur 122 routes sur 129 (la grille dit lesquelles), plus 100 lignes gratuites par mois sur l'identité en lot, et le paiement à l'appel en x402 (USDC ou EURC), sans compte sauf les actes du registre. Crédits prépayés : leur recharge par carte n'est pas encore ouverte.

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

# Ou en serveur local (stdio), avec votre clé ou un portefeuille x402
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp

Routes utilisées et prix

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

Passer à l'action

La première étape est gratuite et vous montre exactement ce que vous achèteriez, sans compte ni clé ; un compte, avec sa clé d'API, ouvre ensuite le quota gratuit.

Voir une réponse réelle (gratuit) Obtenir le devis de /v1/associations/recherche Créer un compte : 150 appels gratuits par mois dans la limite de 2 € de valeur

À lire ensuite

OpenAPI · llms.txt · Catalogue complet des routes et prix