sirenic

French associations

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.

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

GET/v1/associations/recherche

Price
$0.002
Free quota
Included
Family
French associations
Parameters
ParameterWhereExample
qquery · requiredcroix rouge
code_postalquery · optional75
departementquery · optionalno example
positionquery · optionalno example

What is charged

  • 200Ed25519-signed response, charged at the route's price
  • 402Signed x402 quote, nothing is debited
  • 4xxUnknown or invalid identifier, never charged
  • 5xxUpstream source unavailable, or a counted total below the list read (compte_incoherent), never charged

See a real response (free) Get the quote for /v1/associations/recherche

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): 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).

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.

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.

What this route does not do

It does not guarantee to see every matching association as soon as one of its two steps finds more than 3000 titles that pass the filters. The search has a 6-second budget per call, for both its steps (titles starting with the query, then similar titles). Each step first applies the filters (postal code, department, position), then compares at most 3000 of the titles that pass them: the most recently created first for titles starting with the query (creation date descending, unknown dates last), the closest first for similar titles (trigram distance). When a step finds more, the response, served as 200 at the route's price, says so and names the step (resultats_partiels, note_completude). A step that does not fit in the budget, or fails on the database side, is named in etages_abandonnes; the route only answers 503 (recherche_associations_indisponible), without charging, when a step was abandoned and no result at all was found. The served total (total_results, and nombre_total in listes_bornees.resultats) is counted before the cut to the 20 results served: the RNA number typed into q, served and counted even if it does not pass the filters, then the titles that pass the filters in each step run, each once (the similar-titles step only runs if the first returns fewer than 20 titles); it is a lower bound (total_borne_basse) when a step finds more than 3000 or is abandoned.

Neighbouring routes

  • /v1/association/{rna}: $0.005
  • /v1/recherche: $0.002

How you pay

Every route is paid per call, two ways, with no subscription: over x402, in USDC or EURC on the Base network, with no account and no API key; or with the API key of an account, which opens the free quota. Over x402, the first call returns a 402 quote your client settles, then replays the call. A failed call is never billed.

Open today: 150 free calls a month with an account, up to EUR 2 of value, on 122 of 129 routes (the price list says which), with 100 more free lines a month on batch identity, and pay-per-call over x402 (USDC or EURC), with no account except registry filings. Prepaid credits: card top-up is not open yet.

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 and in llms.txt.

One call, end to end

# x402 client (npm): the 402 quote is settled and the call replayed automatically
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Or over MCP, in Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

# Or as a local server (stdio), with your key or an x402 wallet
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp

Routes used and pricing

RoutePriceSampleWhat it returns
/v1/associations/recherche$0.002free sampleSearch 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).

Take it further

The first step is free and shows you exactly what you would be buying, with no account or key; an account, with its API key, then opens the free quota.

See a real response (free) Get the quote for /v1/associations/recherche Create an account: 150 free calls a month up to EUR 2 of value

Read next

OpenAPI · llms.txt · Full route catalogue and pricing