biztrac API and MCP
Norwegian company data from public registers, for your systems and your AI agents. Read-only. Every answer states its sources and whether it is complete; an unknown value is null, never zero.
Quickstart
1. Get a key on the API page in biztrac PRO. It starts with bzk_ and is shown once. Keep it on your server; it is not meant for browsers.
2. Make a call:
export BIZTRAC_KEY=bzk_...
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/923609016
3. See what you have used: GET /v1/usage (free).
Send Accept-Language: en for English labels; Norwegian is the default. Keys are never accepted in the query string.
MCP endpoint
POST https://api.biztrac.no/mcp serves the same operations as tools, with the same key and the same allowance. It speaks MCP revision 2026-07-28 (stateless HTTP) and authenticates with the bearer key, so it works with any client that can send a header.
Claude Code:
claude mcp add --transport http biztrac https://api.biztrac.no/mcp \
--header "Authorization: Bearer $BIZTRAC_KEY"
Cursor and other clients with a JSON configuration:
{"mcpServers": {"biztrac": {
"url": "https://api.biztrac.no/mcp",
"headers": {"Authorization": "Bearer bzk_..."}
}}}
A client that only supports OAuth sign-in or an older MCP revision cannot connect yet.
Operations
Company accounts
GET /v1/companies/{orgnr}/accounts
The company's own filed annual accounts, newest first: revenue, results, balance sheet and ratios, in the filing currency. Figures the register carries at the wrong scale are withheld, not corrected.
tool company_accountsscope companies:read1 unit
| Parameter | Type | Description |
|---|---|---|
orgnr * | string · path | Nine-digit organisation number. |
years | integer · query | Filed years back, default 5. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/923609016/accounts
Peer benchmark
GET /v1/companies/{orgnr}/benchmark
Peers in the same industry and the company's rank among its industry section on the main ratios. Heavy: costs ten units. Says so when the rankings are still building.
tool peer_benchmarkscope network:read10 units
| Parameter | Type | Description |
|---|---|---|
orgnr * | string · path | Nine-digit organisation number. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/923609016/benchmark
Compare companies
GET /v1/companies/compare
The latest filed figures of two to six companies side by side. A company that is unknown or whose figures are withheld stays in the list with its own status.
tool compare_companiesscope network:read1 unit
| Parameter | Type | Description |
|---|---|---|
orgnrs * | array · query | Two to six nine-digit organisation numbers; in the URL repeat the parameter: orgnrs=a&orgnrs=b. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/compare
Company credit score
GET /v1/companies/{orgnr}/credit
biztrac's open credit score (1-100, higher is lower risk) with its band and the filed figures it rests on. A rule over the latest filed accounts, not a credit bureau rating; says so when no accounts exist.
tool company_creditscope companies:read1 unit
| Parameter | Type | Description |
|---|---|---|
orgnr * | string · path | Nine-digit organisation number. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/923609016/credit
Company events
GET /v1/companies/{orgnr}/events
Dated register events for a company (announcements, changes of roles, capital, address), newest first. Role changes name the people concerned; free text has personal identifiers removed.
tool company_eventsscope companies:read1 unit
| Parameter | Type | Description |
|---|---|---|
cursor | string · query | next_cursor of the previous page, unchanged. |
limit | integer · query | Events per page, default 25. |
orgnr * | string · path | Nine-digit organisation number. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/923609016/events
Company holdings
GET /v1/companies/{orgnr}/holdings
What the company owns: its shareholdings in other companies from the shareholder register, and its group structure from Brønnøysund's konsernstruktur.
tool company_holdingsscope companies:read1 unit
| Parameter | Type | Description |
|---|---|---|
orgnr * | string · path | Nine-digit organisation number. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/923609016/holdings
Company owners
GET /v1/companies/{orgnr}/owners
Direct shareholders from the shareholder register and the ultimate owners found by walking the ownership chains. Person owners are named; no identity number is ever returned.
tool company_ownersscope network:read1 unit
| Parameter | Type | Description |
|---|---|---|
orgnr * | string · path | Nine-digit organisation number. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/923609016/owners
Company profile
GET /v1/companies/{orgnr}
Register identity of a Norwegian company (name, status, form, industry, address, purpose), its headline figures from the latest filing, auditor, credit-style ratings, an estimated value (marked as an estimate), attention flags and the latest register events. Every section says whether it is complete, unavailable or withheld.
tool company_profilescope companies:read1 unit
| Parameter | Type | Description |
|---|---|---|
orgnr * | string · path | Nine-digit organisation number. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/923609016
Company properties
GET /v1/companies/{orgnr}/properties
The real property the company holds (and, for scope group, its majority-controlled group) with model value estimates from the property source. When the property source is not connected the answer says so: what the company owns is then unknown, not nothing.
tool company_propertiesscope companies:read1 unit
| Parameter | Type | Description |
|---|---|---|
orgnr * | string · path | Nine-digit organisation number. |
scope | string · query | company (default) or group: the company with every company it controls by majority. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/923609016/properties
Annual report notes
GET /v1/companies/{orgnr}/report-notes
Text read from the company's filed annual report: the auditor's opinion with its findings, going-concern wording, the principles note and the notes you ask for by heading. Names of signatories appear; personal identifiers are removed from every text, and a text that cannot be cleaned is withheld.
tool annual_report_notesscope companies:read1 unit
| Parameter | Type | Description |
|---|---|---|
headings | array · query | Note headings or numbers to return in full, matched case-insensitively (for example revisor, fortsatt drift, 11); omit for the principles note and the index. |
orgnr * | string · path | Nine-digit organisation number. |
year | integer · query | Accounting year of the filing; omit for the newest in the catalogue. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/923609016/report-notes
Company roles
GET /v1/companies/{orgnr}/roles
The registered roles of a company (managing director, board, auditor, signatories) with the names and birth years of the people who hold them. Former roles are listed only on request.
tool company_rolesscope network:read1 unit
| Parameter | Type | Description |
|---|---|---|
include_former | boolean · query | Also list resigned and deregistered roles. |
orgnr * | string · path | Nine-digit organisation number. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/923609016/roles
Search companies
GET /v1/companies
Finds Norwegian companies by name or organisation number. Companies only: no person is ever returned by this search.
tool search_companiesscope companies:read1 unit
| Parameter | Type | Description |
|---|---|---|
limit | integer · query | Matches to return, default 8. |
q * | string · query | Company name or nine-digit organisation number. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies
Company valuation
GET /v1/companies/{orgnr}/valuation
biztrac's model estimate of the company's value (low, mid, high in NOK) over its filed accounts. It is an estimate, never a transaction price, and is withheld when the filed figures are.
tool company_valuationscope companies:read1 unit
| Parameter | Type | Description |
|---|---|---|
orgnr * | string · path | Nine-digit organisation number. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/companies/923609016/valuation
Find connection
GET /v1/connections
Finds how two companies or people are connected through ownership, roles, shared auditors and shared business addresses, up to four hops. Heavy: costs ten units. An endpoint that cannot be resolved answers not_found with candidates.
tool find_connectionscope network:read10 units
| Parameter | Type | Description |
|---|---|---|
from * | string · query | A company or person: name, organisation number or node id. |
to * | string · query | The other company or person. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/connections
Person profile
GET /v1/persons/{id}
A person known to the registers by biztrac's person id: name, registered roles and shareholdings. No identity number, address, email or phone is ever returned. The id is a lookup key, not an identity to store.
tool person_profilescope network:read1 unit
| Parameter | Type | Description |
|---|---|---|
id * | string · path | biztrac's person id, from company.roles or company.owners. |
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/persons/ID
Usage
GET /v1/usage
This month's units used against the customer's allowance, when it resets, and the customer's keys. Free, and available to a suspended customer.
tool scope free
curl -H "Authorization: Bearer $BIZTRAC_KEY" https://api.biztrac.no/v1/usage
Errors
Every error has the same shape: {"error":{"code","message","request_id","details"}}. Quote the request_id when you contact us.
| Status | Code | Meaning | Charged |
|---|---|---|---|
| 400 | invalid_request | The input failed validation; details name the field. | no |
| 401 | invalid_key | No key, an unknown key, or an expired or revoked key. | no |
| 403 | insufficient_scope | The key or the plan does not include the operation's scope. | no |
| 403 | customer_suspended | The customer is suspended. GET /v1/usage still answers. | no |
| 404 | not_found | No such company or person. | no |
| 422 | register_error | The register holds the entity but the answer cannot be built from it. | yes |
| 429 | rate_limited | Too many requests on this key; Retry-After says when. | no |
| 429 | allowance_exhausted | The month's lookup allowance is used; details give the reset time. | no |
| 503 | source_unavailable | A source or the operation is switched off for now. | no |
| 500 | internal | Our fault. Retry; the lookup is refunded. | no |
Metering
Each customer has a monthly allowance of lookup units, shared by all its keys. An ordinary operation costs one unit and a heavy one ten. You are charged for an answer (200) and for a 422; a 404, a rate limit and any failure on our side cost nothing. The allowance resets on the first of the month (UTC).
Operated by Adventis AS · Contact · Data coverage