FAQ
Frequently asked questions
Apier is compliance infrastructure for Norwegian government systems, exposed as an API. It tells an AI agent what a company must do legally, who may act on its behalf, and when each obligation is due — as deterministic, machine-readable answers.
About Apier
- What is Apier?
- Apier is compliance infrastructure for Norwegian government systems, exposed as an API. It answers what a company must do legally, who is allowed to act on its behalf, and when each obligation falls due — as deterministic, machine-readable verdicts an AI agent can plan against. It does not resell company data; it turns raw registry data into the answer a caller actually needs.
- Which Norwegian government systems does Apier connect to?
- Brønnøysundregistrene for company and role data, Altinn 3 for delegation and filing, Maskinporten for machine-to-machine authentication, and Skatteetaten for tax and VAT. Norges Bank exchange rates are exposed as a public tool endpoint. Read endpoints are in production; binding submission to government is gated behind Maskinporten production validation and Altinn scope approval, so validation and dry-run are what work today. The current state of every capability is published at /docs/capability-status.
- Is Apier a government service?
- No. Apier is an independent private service operated by Grov Digital — not a public agency, and not endorsed by one. It reads public registry data under the Norwegian licence for public data reuse (NLOD), and it can act for a company only where that company has granted authority through Altinn. If you need the authoritative source itself rather than a normalised answer, go to Brønnøysundregistrene, Altinn, or Skatteetaten directly.
- How does an AI agent authenticate, and how is that different from a person signing in?
- An agent sends an API key as an
Authorization: Bearerheader. Keys are stored only as SHA-256 hashes, never in plaintext, and rate limits apply per key rather than per IP address. A person signs in to the dashboard with a magic link and a session cookie — there is no password. Some surfaces need no credential at all: the public endpoints, the capability and tool-discovery endpoints, and six MCP tools are deliberately keyless so an agent can evaluate Apier before it has an account. - What happens when a Norwegian government API is down or times out?
- Every upstream call runs through a reliability layer: a circuit breaker skips an upstream already known to be failing, transient failures are retried with exponential backoff and jitter, and a cooperative deadline stops a hung upstream from hanging your request. If the call still fails you get a structured error — a stable error_code, a plain-language explanation, and whether retrying the identical call is safe — never a partial or guessed answer. Apier does not substitute a default for missing government data.
- What does the sandbox prove, and what does it not prove?
- The sandbox proves the shape of your integration: request and response format, the structured-error envelope, idempotency, and how your agent recovers from failure — including failures you trigger on purpose with the
simulate_errorparameter. It proves nothing about your government access. Sandbox requests never reach Altinn, Maskinporten, Brønnøysund, Skatteetaten, or NAV; every answer comes from synthetic fixtures, every response is markedis_sandboxin its_metablock, and a sandbox filing is a local state change that never leaves the system. Whether your Maskinporten client works, and whether a real filing would be accepted, only the live path can tell you. Try it at /sandbox. - What language does Apier answer in?
- The API contract, the field names, and the documentation are English. Error explanations come back in Norwegian bokmål — the language a Norwegian accountant or auditor reads — with English companion fields on the same response, so an English-language agent never has to translate them. Norwegian regulatory terms such as MVA, signaturrett, and årsregnskap are kept as proper nouns rather than translated; the glossary explains each one.
- Is Apier open source, and can I self-host it?
- The service itself is hosted — there is no self-host distribution, because what you are buying is the maintained rulebook and the government credentials behind it, neither of which ships in a container. Published openly: the full API contract at /openapi.json, the MCP server package on npm, and the AVERT specification the execution model follows. Client SDK availability is tracked on /docs/capability-status.
- What happens to my integration when a Norwegian rule changes?
- Rules are stored as versioned data rather than code, so a rule change is a data update, not a deploy. Response contracts are append-only: new fields may appear at any time, but an existing field never changes meaning or type without a
/v2version bump. That means a rule change can alter which obligations apply to a company without ever changing the shape your code parses. Dated, user-visible changes are published on the changelog.
Questions answered elsewhere
Most questions are answered on the page that owns the subject, where the answer sits next to the detail it depends on. This page does not restate them.
- Pricing, billing, and plan changes — What each tier includes, free access, and how billing works.
- Data residency, subprocessors, and audit proof — Where data is hosted, who processes it, the human-approval step before binding writes, and how to prove what Apier did on your behalf.
- Why Apier exists, data freshness, and who it is for — The thesis, whether data is live or cached, and where Apier sits next to accounting platforms.
- Integration errors and how to fix them — Maskinporten 401s, sandbox-versus-production keys, Altinn scope errors, and rate limits.
- Access for companies without a Norwegian registration — The cross-border sequence: what a foreign entity can read, and which gate blocks it first.
- Company lookup, signature rights, and register search — Organisation numbers, Foretaksregisteret, prokura versus signaturrett, and what the registers return.
- Verification, authority, accounts, and deadlines — The product pages, each with the questions specific to that capability.
- The AVERT execution model — Authorize, Validate, Execute, Receipt, Trail — and why traditional APIs fail for agents.
- Connecting an MCP client — Server setup for Claude Desktop, Cursor, and other MCP clients.
- Spørsmål på norsk — This page is English-only. The Norwegian surfaces carry their own questions in bokmål.
Related reading
- /docs/quickstart — the first authenticated call, end to end.
- /docs/capability-status — what is in production, what is dry-run only, and what is gated behind a government approval.
- /knowledge — source-verified topic pages on Norwegian compliance, each carrying the date its facts were last checked.