# Find an association by name

Association names look alike: “comité des fêtes”, “amicale”, “les amis de…”. The answer carries a confidence score and the head-office postal code to tell homonyms apart, and separates the live file from the legacy one.

## What the route returns

Catalogue description, exactly as agents read it:

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

## Expected identifier

Parameter `q`: the title (or an RNA number, resolved directly); optional `code_postal`, `departement`, `position` filters.

> ⚠️ A wrongly formatted identifier in the **path** returns `400` and is **not billed** — but it costs you a round trip. It is the leading cause of failed calls on the foreign routes. A **search** parameter, by contrast, is cleaned up: unsupported characters are stripped and the usable query is served.

## Extract from a genuinely paid response

Dated snapshot from 2026-09-06, truncated to one item per array. It is not live data. The full extract is served **free of charge** from [the samples surface](https://api.sirenic.eu/exemples/), and the schema from the OpenAPI document.

```
{
 "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)"
}
```

## Price and billing

Price: **$0.002**. The authoritative amount is the one in the `402` quote returned by the route itself — not this text, which derives from the same grid but is still just a page.

An error response **cancels the payment**: a `400`, `404` or `503` is never billed. An upstream outage closes the route with a `503` rather than serving a degraded response.

## Calling the 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
```

## What this route does not do

An over-generic pattern across 3.5 million rows may exceed the 8-second budget: the route then answers `503` without charging, rather than a truncated list sold as complete.

## Neighbouring routes

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

## How you pay

Every route is paid **per call**, in USDC or EURC on the Base network, over the x402 protocol: no account to create, no API key, no subscription. The first call returns a `402` quote your client settles, then replays the call. A failed call is never billed.

Would you rather have a euro invoice and prepaid credits? That is **in preparation**, and we will not announce a date until it is open. Write to [contact@sirenic.eu](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs) and we will let you know when it opens.

Paid responses are **Ed25519-signed**: you can later prove what was served to you, and when. The whole catalogue is free to read in the [OpenAPI document](https://api.sirenic.eu/openapi.json) and in [llms.txt](https://api.sirenic.eu/llms.txt).

**One call, end to end**

```
# 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 used and pricing

| Route | Price | Sample | What it returns |
| --- | --- | --- | --- |
| `/v1/associations/recherche` | $0.002 | [free sample](https://api.sirenic.eu/exemples/associations-recherche.json) | Search French associations (loi 1901) by name in the Répertoire national des associations (RNA, Ministry of the Interior): trigram similarity on the normalised title, optional postal-code, department and position filters (active, dissoute, supprimee), top 20 with score_confiance and the RNA number to use on /v1/association/{rna}. Associations with AND without a SIREN; the legacy file (no declaration since 2009) is flagged fichier_source: import. Excludes Alsace-Moselle (local law). |

## Take it further

- [See a real response (free)](https://api.sirenic.eu/exemples/associations-recherche.json)
- [Get the quote for /v1/associations/recherche](https://api.sirenic.eu/v1/associations/recherche)
- [Get notified about euro packs](mailto:contact@sirenic.eu?subject=Euro%20credit%20packs)


Volume figures on this page were measured in our database on 2026-08-19. They are dated snapshots, not live counters.

---

[Home](https://api.sirenic.eu/en) · [Pricing](https://api.sirenic.eu/en/offres) · [Guides](https://api.sirenic.eu/en/articles) · [Routes](https://api.sirenic.eu/en/api) · [Legal notice](https://api.sirenic.eu/mentions-legales) · [Privacy](https://api.sirenic.eu/en/privacy)