# API reference

One page per route in the pricing grid, with its price, an extract from a genuinely paid response, the expected identifier format and what the route does not do.

- [Search a French company](https://api.sirenic.eu/en/api/french-company-search-api-by-name-or-company-number) — Resolves a trading name to a company number, with a confidence score that disambiguates namesakes. The cheapest route in the catalogue.
- [Identity record of a French company](https://api.sirenic.eu/en/api/company-profile-api-by-company-number-official-identity) — A company's official identity: legal name, form, status, creation date, head office, activity code, computed VAT number.
- [Establishments of a company](https://api.sirenic.eu/en/api/establishments-api-siret-french-company) — The list of a company's establishment identifiers with addresses, activity code and status. The head office is flagged.
- [À-la-carte company dossier](https://api.sirenic.eu/en/api/company-dossier-api-by-blocks-pay-only-what-you-read) — A single call that assembles the blocks you ask for, instead of chaining several routes or paying for a full record.
- [KYB file for a French company](https://api.sirenic.eu/en/api/kyb-api-business-verification-file-with-per-block-provenance) — Six blocks in one call: identity, officers, legal alerts, accounts, sanctions screening of the company and its officers, computed VAT.
- [Batch KYB, up to 100 companies](https://api.sirenic.eu/en/api/batch-kyb-api-2-100-companies-one-call) — The same full file for 2 to 100 company numbers, at the batch unit price. An unresolved number comes back explicitly; it is not hidden.
- [Intelligence brief on a company](https://api.sirenic.eu/en/api/company-intelligence-brief-api) — The broadest call in the catalogue: a cross-source synthesis of what official registries say about a company, in one response.
- [PDF report on a company](https://api.sirenic.eu/en/api/pdf-report-api-on-french-company) — A laid-out document, meant to be handed to a human — credit committee, supplier file, internal memo annex.
- [B2B prospecting over the official registry](https://api.sirenic.eu/en/api/french-b2b-prospecting-api-company-lists-by-criteria) — Lists of active companies filtered by activity, area, legal form, workforce, age and certifications. 100 companies per page, one payment per page.
- [A company's intellectual property](https://api.sirenic.eu/en/api/company-intellectual-property-api-trademarks-patents-designs) — Trademarks, patents, designs and models attached to a French company, from the official industrial-property registers.
- [Documents filed with the register by a company](https://api.sirenic.eu/en/api/filed-documents-list-api-deeds-accounts-company) — The inventory of filed deeds and accounts, with dates and references — the step before downloading a specific document.
- [Download a filed document](https://api.sirenic.eu/en/api/download-document-filed-with-register-pdf) — The PDF of a deed or set of accounts filed with the national register, by type and reference, obtained from the listing route.
- [Searching a director's offices](https://api.sirenic.eu/en/api/reverse-director-search-api-france) — From a surname, the French companies where a person of that name holds or held an office, with the company number and role.
- [A company's annual accounts and ratios](https://api.sirenic.eu/en/api/french-company-s-annual-accounts-financial-ratios) — One financial year per row, with official ratios and detailed tax-form line items, for up to the last 20 filed years.
- [A company's default-risk score](https://api.sirenic.eu/en/api/company-default-risk-score-api-scorecard-included) — A 0-to-100 score at roughly 12 months, computed at call time, with every component, its threshold and a confidence level.
- [Written risk read-out of a company](https://api.sirenic.eu/en/api/company-risk-read-out-api-verdict-strengths-warning-signs) — A bilingual read-out meant for a human: verdict, strengths, warning signs, activity trend, confidence level.
- [Compare 2 to 5 companies](https://api.sirenic.eu/en/api/compare-2-5-french-companies-axis-by-axis) — Rankings per axis, never an overall winner, and a comparability block that flags when the comparison is meaningless.
- [Statistics for an activity sector](https://api.sirenic.eu/en/api/sector-statistics-api-by-activity-code-medians-quartiles) — Number of active companies, median age and quartiles, workforce distribution, and financial medians from 5 filers upwards.
- [Legal alerts on a company](https://api.sirenic.eu/en/api/legal-alerts-api-insolvency-proceedings-deregistrations) — Insolvency proceedings, related court decisions, deregistrations and business sales, grouped and most recent first.
- [New announcements since a date](https://api.sirenic.eu/en/api/company-s-new-legal-announcements-since-date) — The polling endpoint for lightweight monitoring: announcements published since the date you give, in reverse chronological order.
- [Search legal announcements by criteria](https://api.sirenic.eu/en/api/legal-announcements-search-api-by-criteria-date-department) — By announcement family, date window and department — not by company. Up to 100 announcements with their structured judgment.
- [Create a company watchlist](https://api.sirenic.eu/en/api/company-monitoring-api-1-100-targets-daily-checks) — 1 to 100 targets checked daily against official sources, for 30, 90 or 365 days. Ed25519-signed webhook, e-mail digest, or polling.
- [Renew a watchlist](https://api.sirenic.eu/en/api/renew-company-watchlist) — Extend a watch by 30, 90 or 365 days, whatever its original duration. Possible until 7 days after expiry.
- [Screen a name against sanctions lists](https://api.sirenic.eu/en/api/sanctions-screening-api-eu-ofac-uk-france-switzerland) — Six official sources, fuzzy matching with a 0-100 confidence score per hit, and each list's publication date.
- [French financial regulator alerts](https://api.sirenic.eu/en/api/french-market-authority-blacklist-registrations) — Unauthorised websites, impersonations, registered digital-asset providers and licensed asset managers, by name or company number.
- [A company's regulatory authorisations](https://api.sirenic.eu/en/api/company-authorisations-api-payments-e-money-insurance) — Three official registers in one call, with authorisation dates, licensed services, European passporting and withdrawals.
- [A company's lobbying profile](https://api.sirenic.eu/en/api/company-lobbying-profile-api-official-register) — Registration status, category, expense brackets per year, recent subjects, clients for consultancies, declaration failures.
- [A company's industrial risks](https://api.sirenic.eu/en/api/company-s-regulated-sites-seveso-status) — The environmentally regulated installations attached to a company, with their classification, including Seveso.
- [Share capital and ownership from public filings](https://api.sirenic.eu/en/api/share-capital-ownership-from-filed-articles) — Extraction from the latest publicly filed deed: share capital, legal form, shareholders with percentages, notable clauses, confidence level.
- [Supplier verification pack](https://api.sirenic.eu/en/api/supplier-verification-api-before-payment-identity-vat-iban) — Legal identity, obligation dates, VAT validated live at VIES, IBAN form-checked with the bank identified, deterministic verdict.
- [Cross-check an invoice's identifiers](https://api.sirenic.eu/en/api/incoming-invoice-check-api-company-number-vat-iban-cross) — The printed VAT number is compared with the one computed from the company number, and validated at VIES. Verdict: coherent, incoherent or unverifiable.
- [Preparing a compliant e-invoice](https://api.sirenic.eu/en/api/prepare-compliant-french-e-invoice) — Legal name and form, status, computed VAT with a VIES pointer, establishments and addresses, activity code, indicative obligation dates.
- [Validate a VAT number at VIES](https://api.sirenic.eu/en/api/validate-intra-community-vat-number-at-vies) — Live validation for all member states, with the VIES consultation identifier kept as proof of the check.
- [Check an IBAN and identify its bank](https://api.sirenic.eu/en/api/iban-check-api-structure-key-digits-bank-identified) — ISO 13616 structure, mod-97 key digits, and bank identification from free official registries (France, Belgium, Austria, Netherlands, Germany).
- [Verify a Belgian or Polish supplier](https://api.sirenic.eu/en/api/belgian-polish-supplier-verification-api-peppol-white-list) — Registry identity, VAT at VIES, Peppol reachability in Belgium, and in Poland the official check: is this IBAN declared by the taxpayer?
- [Upcoming public-contract expiries](https://api.sirenic.eu/en/api/public-contract-expiries-api-ahead-notice) — Contracts whose estimated end falls inside your 1-to-24-month window, filterable by CPV segment and department, with the incumbent holder.
- [Profile of a public buyer](https://api.sirenic.eu/en/api/public-buyer-profile-api-buying-habits-competitive-intensity) — Volumes and amounts, activity by year, CPV segments, incumbent suppliers and their contracts expiring within 18 months, average bids received.
- [Public contracts won by a company](https://api.sirenic.eu/en/api/public-contracts-won-by-french-company) — Buyers, amounts, dates and procedures of already-awarded contracts, as aggregates and as recent contracts with their estimated end.
- [A company's EU public contracts](https://api.sirenic.eu/en/api/eu-public-contracts-awarded-company) — Awards within the European perimeter, from a source distinct from the French data and not superimposable on it.
- [Rivals on your public-procurement segments](https://api.sirenic.eu/en/api/rivals-on-same-public-procurement-segments-cpv) — The companies that won on the same CPV segments over the last three years, with contract counts, amounts and shared segments.
- [Search a European company](https://api.sirenic.eu/en/api/european-company-search-api-unified-schema) — Search by name across several official registers, returned in a single response shape, with a match confidence score.
- [Unified profile of a European company](https://api.sirenic.eu/en/api/unified-european-company-profile-api-by-country-id) — Identity, legal form, status, creation date, head office, VAT, Legal Entity Identifier and register link, in a single schema.
- [European authorisations of investment firms](https://api.sirenic.eu/en/api/european-authorisations-api-investment-firms-esma-registers) — Search by name or Legal Entity Identifier in the official European registers: authorisation status, home and host states, competent authority.
- [Belgian and Finnish annual accounts](https://api.sirenic.eu/en/api/belgian-finnish-annual-accounts-api) — Belgium: every filing reference at the Central Balance Sheet Office since 1978. Finland: available years as XBRL filings, empty filings filtered out.
- [Fetch an accounts filing by its reference](https://api.sirenic.eu/en/api/fetch-european-accounts-filing-by-reference) — The content of a specific filing, identified by the reference obtained from the listing route.
- [Directors' dealings of listed issuers](https://api.sirenic.eu/en/api/directors-dealings-api-eu-market-abuse-regulation) — Managers' transaction notifications for listed issuers, as published by the Belgian and German market authorities.
- [Profile of a Belgian company](https://api.sirenic.eu/en/api/belgian-company-profile-api-crossroads-bank-enterprises) — Identity from the Belgian register, national activity codes and establishments, by 10-digit enterprise number.
- [Profile of a Swiss company](https://api.sirenic.eu/en/api/swiss-company-profile-api-zefix-che-identifier) — Identity from the Swiss commercial register, queried live by CHE enterprise identifier.
- [Profile of a Norwegian company](https://api.sirenic.eu/en/api/norwegian-company-profile-api-enhetsregisteret) — Identity from the Norwegian central register of legal entities, by 9-digit organisation number.
- [Profile of a Czech company](https://api.sirenic.eu/en/api/czech-company-profile-api-ares-ico-identifier) — Identity from the Czech register, queried live by IČO identifier. Legal persons only.
- [Profile of a Slovak company](https://api.sirenic.eu/en/api/slovak-company-profile-api-register-legal-persons) — Identity from the Slovak register of legal persons, queried live by IČO identifier.
- [Profile of a Finnish company](https://api.sirenic.eu/en/api/finnish-company-profile-api-patent-registration-office) — Identity from the Finnish register, queried live by business identifier in the NNNNNNN-N format.
- [Profile of a Polish company](https://api.sirenic.eu/en/api/polish-company-profile-api-national-court-register-krs) — Identity from the Polish National Court Register, queried live by KRS number.
- [Profile of an Estonian company](https://api.sirenic.eu/en/api/estonian-company-profile-api-e-business-register) — Identity from the Estonian register, served from a local copy, by national registration code.
- [Profile of a Latvian company](https://api.sirenic.eu/en/api/latvian-company-profile-api-register-enterprises) — Identity from the Latvian Register of Enterprises, served from a locally held copy refreshed daily.
- [Profile of a Swedish company](https://api.sirenic.eu/en/api/swedish-company-profile-api-bolagsverket) — Identity from the Swedish companies register, by organisation number, with an age guard that closes the route if the copy goes stale.
- [Swedish annual accounts](https://api.sirenic.eu/en/api/swedish-annual-accounts-api-ixbrl-filings) — Accounts filed in Sweden, read from the register's iXBRL filings, by organisation number.
- [Danish annual accounts](https://api.sirenic.eu/en/api/danish-annual-accounts-api-cvr-register-xbrl-filings) — The list of years filed in Denmark, by CVR number, from a local copy under an age guard.
- [Danish accounts for a specific year](https://api.sirenic.eu/en/api/danish-accounts-specific-year-by-closing-date) — The figures for a Danish year identified by its closing date, as it appears in the listing.
- [Slovak annual accounts](https://api.sirenic.eu/en/api/slovak-annual-accounts-api-register-financial-statements) — Years filed with the Slovak register of financial statements, by IČO identifier, from a local copy under an age guard.
- [Slovak accounts for a specific year](https://api.sirenic.eu/en/api/slovak-accounts-specific-year-by-closing-date) — The figures for a Slovak year identified by its closing date, taken from the list of years.
- [British annual accounts](https://api.sirenic.eu/en/api/british-annual-accounts-api-companies-house) — The list of financial years filed with the British register, by company number — the step before fetching one specific year's figures.
- [British accounts for a specific year](https://api.sirenic.eu/en/api/british-accounts-specific-year-by-closing-date) — The figures for a British year identified by its closing date, taken from the listing.
- [Latvian annual accounts](https://api.sirenic.eu/en/api/latvian-annual-accounts-api-register-open-data) — Accounts filed in Latvia, from the register's open data, refreshed daily.
- [Estonian annual accounts](https://api.sirenic.eu/en/api/estonian-annual-accounts-api) — Accounts filed in Estonia, served from a local copy whose cadence follows the register's republications.
- [Norwegian annual accounts](https://api.sirenic.eu/en/api/norwegian-annual-accounts-api-queried-live) — Accounts filed in Norway, queried live at the register on every call — there is no local stock.
- [Officers of a British company](https://api.sirenic.eu/en/api/british-company-officers-api-companies-house) — Officers declared to the British register, live, with their roles and dates.
- [Beneficial owners of a British company](https://api.sirenic.eu/en/api/british-beneficial-owners-api-open-psc-register) — Individual and corporate controllers, natures of control with ownership and voting bands, notification dates, official statements.
- [Insolvency of a British company](https://api.sirenic.eu/en/api/british-company-insolvency-api) — Insolvency proceedings declared to the British register, live, by company number.
- [Insolvency of a Czech company](https://api.sirenic.eu/en/api/czech-company-insolvency-api-isir-register) — Czech insolvency cases attached to an IČO identifier, from a local copy under an age guard.
- [Insolvency of a Latvian company](https://api.sirenic.eu/en/api/latvian-company-insolvency-api) — Latvian insolvency proceedings, from the register's open data, refreshed daily.
- [Officers of a Latvian company](https://api.sirenic.eu/en/api/latvian-company-officers-api) — Officers declared to the Latvian register, from open data, with their role.
- [Beneficial owners of a Latvian company](https://api.sirenic.eu/en/api/latvian-beneficial-owners-api-open-national-register) — Beneficial owners registered in Latvia: name, nationality, country of residence, registration date.
- [Officers of a Danish company](https://api.sirenic.eu/en/api/danish-company-officers-api-cvr-register) — Officers declared to the Danish register, with the option to include past offices.
- [Estonian register events](https://api.sirenic.eu/en/api/estonian-register-events-api-court-orders) — Published court orders concerning an Estonian company, from the register's daily dataset.
- [Swedish register events](https://api.sirenic.eu/en/api/swedish-register-events-api-including-compulsory-dissolution) — Published events concerning a Swedish company, including compulsory-dissolution proceedings.
- [Norwegian register event journal](https://api.sirenic.eu/en/api/norwegian-register-event-journal-api) — Events published by the Norwegian register for an entity, with a two-tier notion of freshness.
- [Polish register events](https://api.sirenic.eu/en/api/polish-court-register-events-api) — Events published in the Polish court register for a company, in a structured and minimised form.
- [Spanish register filings](https://api.sirenic.eu/en/api/spanish-register-filings-api-borme-sheet-key) — Filings published in the Spanish official commercial-register gazette, by sheet key.