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

ParameterTypeDescription
orgnr *string · pathNine-digit organisation number.
yearsinteger · queryFiled 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

ParameterTypeDescription
orgnr *string · pathNine-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

ParameterTypeDescription
orgnrs *array · queryTwo 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

ParameterTypeDescription
orgnr *string · pathNine-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

ParameterTypeDescription
cursorstring · querynext_cursor of the previous page, unchanged.
limitinteger · queryEvents per page, default 25.
orgnr *string · pathNine-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

ParameterTypeDescription
orgnr *string · pathNine-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

ParameterTypeDescription
orgnr *string · pathNine-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

ParameterTypeDescription
orgnr *string · pathNine-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

ParameterTypeDescription
orgnr *string · pathNine-digit organisation number.
scopestring · querycompany (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

ParameterTypeDescription
headingsarray · queryNote 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 · pathNine-digit organisation number.
yearinteger · queryAccounting 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

ParameterTypeDescription
include_formerboolean · queryAlso list resigned and deregistered roles.
orgnr *string · pathNine-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

ParameterTypeDescription
limitinteger · queryMatches to return, default 8.
q *string · queryCompany 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

ParameterTypeDescription
orgnr *string · pathNine-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

ParameterTypeDescription
from *string · queryA company or person: name, organisation number or node id.
to *string · queryThe 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

ParameterTypeDescription
id *string · pathbiztrac'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.

StatusCodeMeaningCharged
400invalid_requestThe input failed validation; details name the field.no
401invalid_keyNo key, an unknown key, or an expired or revoked key.no
403insufficient_scopeThe key or the plan does not include the operation's scope.no
403customer_suspendedThe customer is suspended. GET /v1/usage still answers.no
404not_foundNo such company or person.no
422register_errorThe register holds the entity but the answer cannot be built from it.yes
429rate_limitedToo many requests on this key; Retry-After says when.no
429allowance_exhaustedThe month's lookup allowance is used; details give the reset time.no
503source_unavailableA source or the operation is switched off for now.no
500internalOur 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