Estonian company officers and governance
get_estonian_company_officersOfficers and governance of an Estonian company from the official e-Business Register open data (RIK, CC BY 4.0), refreshed daily from the national photo: management board members, procurators, liquidators, bankruptcy trustees, general and limited partners, contact persons, share-register keepers (persons entered on the registry card), plus supervisory board members and chair, audit firms, auditors and bankruptcy committee members recorded beside the card. organe and role are closed lists with the register's code and wording (GET /v1/lecture); current mandates only — the source publishes no end date or history — with the registration date; standard representation rules (statutory template texts) and special conditions (type only). GDPR: natural persons come with first name, last name and role only — never the published identifier hash, birth date, address or e-mail. Legal persons only: sole proprietorships (FIE) are refused (404, payment cancelled). A known legal person with no registered role gets aucun_mandat_inscrit: true. Paid via x402 ($0.01 in USDC or EURC).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| api_key | No | Optional Sirenic API key (srn_live_…) to pay with prepaid credits instead of x402 — no wallet needed. Get one at https://api.sirenic.eu/compte. Ignored when x_payment is provided (the signed payment wins). On insufficient balance the tool returns a credits error, not an x402 quote. | |
| x_payment | No | Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote. | |
| registrikood | Yes | 8-digit Estonian registry code (registrikood, e-Business Register), e.g. 10003666 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | How to settle the quote, present when payment_required is true. | |
| quote | No | The signable x402 payment requirements when payment_required is true: {x402Version, accepts[]} where each entry carries scheme, network, amount, asset and payTo (USDC and EURC options at the same numeric amount). Sign one entry and call again with `x_payment`. | |
| resultat | No | The endpoint's JSON response when payment_required is false. Paid responses carry `source`, `disclaimer` and an Ed25519 signature, and every paid JSON response carries a `provenance` array (all tools since 2026-09-06) — one entry per block served, with the official register, licence, version, `as_of` date and `precision_as_of` (what that date means), plus the common per-block envelope: `etat` in a closed list (servi, absence_mesuree, absence_non_conclusive, partiel, perime, indisponible, sans_objet), `motif` when unavailable, `age_jours` (only for publication or ingestion dates), `couverture` (complete / partielle / non_mesurable with its measure) and `confiance` in bands (faible / moyenne / forte, only where a measure grounds it, never averaged across blocks). Read the states before the numbers: an absence_non_conclusive, indisponible or partiel block is never « nothing to report » — only absence_mesuree asserts an absence. Register codes: GET /v1/provenance/registres ; states, closed lists and reading rules: GET /v1/lecture (both free). The PDF tools carry no JSON envelope (the PDF report prints it). | |
| payment_required | Yes | True when this response is an x402 payment quote instead of data: settle one of the quote's `accepts` options and call the tool again with `x_payment`. |