# Sirenic French Association Search (RNA)

> Sirenic French Association Search (RNA) is a paid API for AI agents from api.sirenic.eu, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-13).

Searches the French national association register (RNA) by name using trigram similarity, returning up to 20 ranked matches with confidence scores and RNA numbers.

## Facts

- Endpoint: GET https://api.sirenic.eu/v1/associations/recherche
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sirenic-french-association-search-rna-88a4f977
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KKinoFowBsu_g1TNDoCzV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sirenic-french-association-search-rna-88a4f977
```

Example prompt: Can you search the French association register for associations called 'Les Amis de la Forêt' that are currently active and located in the 69 department (Rhône)?

## When to prefer this

Use this endpoint when you need to find a French loi 1901 association by name in the official RNA registry, especially when you have a partial or approximate name and need fuzzy matching via trigram similarity. Prefer this over direct RNA number lookup (/v1/association/{rna}) when you don't already know the exact RNA number. Choose this over general web search when you need authoritative government registry data including legal status, postal location, and confidence-ranked results. Note: does not cover Alsace-Moselle associations.

## Known failure modes

- 400 Bad Request if the query string contains no searchable characters after stripping unsupported characters
- Empty result list if no associations match the name query in the RNA
- No results for Alsace-Moselle associations (excluded by local law)
- Partial matches only for rare or very short association names
- Legacy pre-2009 associations may have incomplete data (fichier_source: import)
- Department filter is silently ignored when code_postal is also provided

## How this service works

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

## Output

Returns up to 20 associations ranked by trigram-similarity confidence score, each including: RNA number (Wxxxxxxxxxxx), normalised title, position (active/dissoute/supprimee), registered office postal code, department, fichier_source flag (import for legacy pre-2009 records), and a score_confiance value. The RNA number can be passed to /v1/association/{rna} for full profile details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Association title, or an RNA number (W + 9) resolved directly. Unsupported characters are stripped; 400 only if nothing searchable is left (1-100 chars once cleaned)."
      },
      "position": {
       "type": "string",
       "description": "Optional position filter: active, dissoute or supprimee (default: all)"
      },
      "code_postal": {
       "type": "string",
       "description": "Optional postal code or prefix (2-5 digits) of the registered office, e.g. 75 or 75014"
      },
      "departement": {
       "type": "string",
       "description": "Optional department: 01-95, 2A, 2B or 971-989 (ignored when code_postal is given)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sirenic-french-association-search-rna-88a4f977/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.sirenic.eu](https://www.zero.xyz/host/api.sirenic.eu/llms.txt)