# Sirenic > Pay-per-call API for official French company data (INSEE Sirene / INPI RNE > open data, Etalab 2.0 license). AI agents pay per request in USDC on > base via the x402 protocol (HTTP 402). No account, no API key. ## How to use 1. Call any /v1 endpoint. Without payment you get HTTP 402 with x402 payment requirements (price, USDC asset, pay-to address, network eip155:8453). 2. Sign the payment with an x402 client (e.g. npm package @x402/fetch) and retry with the PAYMENT-SIGNATURE header. The response is released once the facilitator confirms settlement. ## Endpoints - `GET /v1/recherche` ($0.001): Search French companies by name or SIREN. Returns top 10 matches with identity, SIREN, NAF code, city and status. Source: INSEE Sirene / INPI RNE open data. - `GET /v1/entreprise/:siren` ($0.005): Full French company profile by SIREN: legal name, legal form, head-office address, NAF code, workforce bracket, creation date, active/ceased status, officers (name, role), collective agreement, computed intra-EU VAT number. - `GET /v1/entreprise/:siren/etablissements` ($0.003): List of all establishments (SIRET) of a French company with addresses and open/closed status. - `GET /v1/entreprise/:siren/alertes` ($0.01): Legal alerts for a French company from the official BODACC gazette: insolvency proceedings (procedures collectives), deregistrations, business sales. Grouped, most recent first. - `GET /v1/entreprise/:siren/finances` ($0.01): Annual financial data of a French company from filed accounts (INPI / Banque de France ratios): revenue, EBITDA, net income, debt ratio, financial autonomy — one entry per fiscal year. Also includes the full structured tax-form line items (liasse fiscale) as keyed by the INPI registry for the latest 3 public fiscal years. - `GET /v1/entreprise/:siren/marches-publics` ($0.01): Public procurement contracts won by a French company (official DECP data): buyers, amounts, dates, procedures — aggregates plus the most recent contracts. - `GET /v1/entreprise/:siren/sante` ($0.15): AI-generated business-health summary of a French company in natural language (French): strengths, warning signs, activity trend and confidence level, produced by Claude from official data only (identity, BODACC alerts, filed financials, sanctions screening). Cached 7 days. - `GET /v1/kyb/batch` ($0.105): Batch KYB: full KYB files for 2 to 100 French companies in one call (comma-separated `sirens`). Billed per company at $0.105 (30% off the $0.15 unit price); the amount is quoted from the number of SIREN. A SIREN with no diffusible company is returned as trouve=false and billed as one lookup. Built for prospecting and compliance agents working on lists. - `GET /v1/kyb/:siren` ($0.15): Complete KYB (Know Your Business) file for a French company in one call: official identity, officers, BODACC legal alerts (insolvency, deregistration), filed financials, sanctions screening of the company and each officer against the 5 official lists, computed VAT number, and a completeness score with the list of missing blocks. - `GET /v1/sanctions/check` ($0.02): Sanctions screening of a person or company name against the 5 official lists (UN consolidated, EU FSF, US OFAC SDN, UK Sanctions List, French national asset-freeze register). Fuzzy matching with a 0-100 confidence score per hit — never a bare yes/no. - `GET /v1/prospection` ($0.02): Multi-criteria prospecting search over the full French company registry (29.8M companies): filter by NAF/APE activity code, departement or postal-code prefix, legal form, workforce bracket, company age, active RGE environmental certification, gender-equality index. 100 active companies per page, each page is one payment. - `GET /v1/rapport/:siren` ($0.50): On-demand PDF report of a French company: the full KYB file (identity, officers, BODACC alerts, financials, sanctions screening, completeness score) laid out as a shareable A4 document, including the AI health summary when one is cached. Response is application/pdf. - `GET /v1/eu/recherche` ($0.003): Search European companies by name across official registers in one unified schema: Norway, Estonia, Latvia (local base), Denmark and UK when enabled, plus worldwide GLEIF (LEI) coverage of financial entities and large groups. Top 10 matches with country, national ID and status. - `GET /v1/eu/entreprise/:pays/:id` ($0.01): Unified European company profile by country code and national register ID: same JSON schema for every country (identity, legal form, normalized status, creation date, head office, VAT, LEI, official register link). Countries: NO, EE, LV (+ BE, DK, GB when enabled); other jurisdictions served from GLEIF when the entity has an LEI. - `GET /v1/entreprise/:siren/documents` ($0.02): List of official documents filed by a French company at the INPI RNE registry: legal deeds (statutes, general-meeting minutes, mergers...) and filed annual accounts, with filing dates and document IDs. Only documents the registry marks as public. Cached 24h. - `GET /v1/documents/:type/:id` ($0.10): Download an official company document (PDF) from the INPI RNE registry by type (actes | bilans) and document ID from the document list endpoint. Typical size 1-10 MB. Streamed as-is from the registry at request time — response is application/pdf. - `GET /v1/tva/verifier/:numero` ($0.003): Validate any EU intra-community VAT number (all member states) against the official VIES service. Returns valid/invalid/unavailable status with the VIES consultation identifier as proof. Option geo=true on company profile and establishments adds GPS coordinates. Company profiles also include index_egapro (gender-equality index) and certifications_rge (active RGE environmental certifications) when available. Free endpoints: GET / (this landing), GET /preview/entreprise/55203253400646 (free sample of the full-profile response), GET /openapi.json, GET /healthz. MCP server (streamable HTTP): POST https://api.sirenic.eu/mcp — manifest at /.well-known/mcp.json. A2A agent card: /.well-known/agent.json. ## Data & compliance Source: INSEE Sirene and INPI RNE via recherche-entreprises.api.gouv.fr, Etalab 2.0 open license. Company officers: only name, role and birth year are ever exposed (French GDPR/INPI rules). Companies with restricted diffusion status return a minimal legal record. Every JSON response carries `source` and `disclaimer` fields.