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

## 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](https://api.sirenic.eu/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](mailto:contact@sirenic.eu?subject=Packs%20en%20euros) 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](https://api.sirenic.eu/openapi.json) et le [llms.txt](https://api.sirenic.eu/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](https://api.sirenic.eu/exemples/associations-recherche.json) | 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

- [Voir une réponse réelle (gratuit)](https://api.sirenic.eu/exemples/associations-recherche.json)
- [Obtenir le devis de /v1/associations/recherche](https://api.sirenic.eu/v1/associations/recherche)
- [Être prévenu des packs en euros](mailto:contact@sirenic.eu?subject=Packs%20en%20euros)


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.

---

[Accueil](https://api.sirenic.eu/) · [Offres](https://api.sirenic.eu/offres) · [Articles](https://api.sirenic.eu/articles) · [Routes](https://api.sirenic.eu/api) · [Mentions légales](https://api.sirenic.eu/mentions-legales) · [Confidentialité](https://api.sirenic.eu/confidentialite)