Orakel-dokumentasjon
API-referanse

Companies

Company lookup, search, and enrichment

Denne siden finnes foreløpig bare på engelsk.

GET/api/companiesAPI key

Search companies

Paginated full-text and filter search across all countries. Free-tier keys require at least one filter parameter.

countrystringoptional

min 2 chars, max 2 chars

qstringoptional
nacestringoptional
orgFormstringoptional
municipalitystringoptional
countystringoptional

/^\d{2}$/

latnumberoptional

≥ -90, ≤ 90

lngnumberoptional

≥ -180, ≤ 180

radiusKmnumberoptional

≤ 500

bboxMinLatnumberoptional

≥ -90, ≤ 90

bboxMinLngnumberoptional

≥ -180, ≤ 180

bboxMaxLatnumberoptional

≥ -90, ≤ 90

bboxMaxLngnumberoptional

≥ -180, ≤ 180

isHiringstringoptional

"true" | "false"

minOpenRolesintegeroptional

≥ 1, ≤ 9007199254740991

jobCategorystringoptional
maxTransitDistanceKmnumberoptional
minTransitDistanceKmnumberoptional
maxParkingDistanceKmnumberoptional
maxAirportDistanceKmnumberoptional
minEmployeesintegeroptional

≥ 0, ≤ 9007199254740991

maxEmployeesintegeroptional

≥ 0, ≤ 9007199254740991

minRevenuenumberoptional
maxRevenuenumberoptional
isBankruptstringoptional

"true" | "false"

isInGroupstringoptional

"true" | "false"

hasParentstringoptional

"true" | "false"

hasTechnologystringoptional
hasAnyAdPixelstringoptional

"true" | "false"

compactstringoptional

"true" | "false"

cursorstringoptional
limitintegeroptional

≥ 1, ≤ 100

Default: 20

sortstringoptional

"name" | "employeeCount" | "foundingDate" | "updatedAt" | "latestRevenueNOK" | "distance"

Default: name

orderstringoptional

"asc" | "desc"

Default: asc

200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
GET/api/companies/{orgNumber}API key

Get company by org number

Full company profile including financials, roles, technologies, enrichment, and pre-computed signals, and an `ownership` summary (ten largest shareholders plus the total holder count; the full list is GET /api/companies/{orgNumber}/shareholders). Pass ?include=context for SSB market benchmarks, ?include=advisors for accounting firm and auditor profiles.

orgNumberstringrequired
countrystringoptional

ISO 3166-1 alpha-2 country code. Default: NO.

min 2 chars, max 2 chars

includestringoptional

Embed additional data: 'context' for SSB market context, 'advisors' for firm profiles.

"context" | "advisors"

200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
GET/api/companies/{orgNumber}/eventsAPI key

Get company events

Returns a chronological list of events for a company (filings, ownership changes, name changes, etc.).

orgNumberstringrequired
countrystringoptional

ISO 3166-1 alpha-2 country code. Default: NO.

min 2 chars, max 2 chars

limitintegeroptional

Maximum number of events to return (1–100). Default: 20.

≥ 1, ≤ 100

200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
POST/api/companies/{orgNumber}/financial-historyAPI key

Fetch 5-year financial history (PDF extraction)

Triggers PDF extraction of up to 5 years of financial statements from Regnskapsregisteret. Available on every active key. Returns 403 only if financial history has been disabled for your key. Blocks until complete (~45 s on first call).

orgNumberstringrequired
200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
GET/api/companies/{orgNumber}/supportAPI key

Get public support awards

State-aid awards from Støtteregisteret (Brønnøysundregistrene) and grants, loans and guarantees from Innovasjon Norge for a Norwegian company. Newest first. Skatteetaten's per-period reduced employer's contribution (differensiert arbeidsgiveravgift, reported since 2026) is aggregated in taxRelief instead of listed. Norway-only.

orgNumberstringrequired
200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
POST/api/companies/enrichAPI key

Batch enrich companies

Bulk lookup for up to 100 companies. Returns full profiles for found companies (with an `ownership` summary of the ten largest shareholders and the total holder count, not the full list) and a notFound list for missing ones. Pass { orgNumbers: string[] } for Norwegian companies or { pairs: [{ orgNumber, country }] } for multi-country.

200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
GET/api/companies/by-domainAPI key

Resolve domain to company

Returns the best matching company for a given domain. Checks primaryDomain (exact, indexed), enrichedDomains (array of known domains), then raw website field in priority order. Protocol and www prefix are stripped automatically. Returns 404 if no match is found.

domainstringrequired

Domain to resolve, e.g. ledidi.no or https://www.ledidi.no - protocol and www are stripped automatically.

countrystringoptional

ISO 3166-1 alpha-2 country code. Default: NO.

min 2 chars, max 2 chars

200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
GET/api/companies/matchAPI key

Match a CRM company to Orakel

Suggests up to 3 companies for a name and optional website, best first. Confidence 0.95 means the domain and the name agree and the match is safe to write automatically; anything lower should be picked by a person. Requires an API key that belongs to an account.

namestringrequired

Company name as it appears in the CRM.

domainstringoptional

Website or domain, e.g. acme.no. Protocol and www are stripped.

countrystringoptional

ISO 3166-1 alpha-2 country code. Default: all countries.

min 2 chars, max 2 chars

200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
GET/api/companies/{orgNumber}/cardAPI key

Get the CRM card for a company

Everything a CRM company card shows, in one call: overview, up to 5 years of financials, CEO and board, active tenders and technologies. People who have asked to be hidden are left out. Requires an API key that belongs to an account.

orgNumberstringrequired
200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
GET/api/companies/{orgNumber}/contactsAPI key

Find contacts on a company website

Scrapes emails and phones from one Norwegian company's primary domain, falling back to its registry website. Returns empty lists and noWebsite: true when no website is known. Requires an account-linked API key. Invalid organization numbers return 400, unknown companies 404 and failed scrapes 502. Failed scrapes count toward API usage quotas. Shares a limit of 20 requests per account per 15 minutes with domain-contribution. Returns 429 when the work limit is reached and 503 when the limiter is unavailable. These work-limit refusals do not count toward API usage quotas; other responses keep counting.

orgNumberstringrequired
200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
POST/api/companies/{orgNumber}/domain-contributionAPI key

Contribute a company domain for review

Queues a proposed domain for a Norwegian company for human review. Invalid or blocklisted domains return 400; unknown companies return 404. queued is false when the domain already matches or an existing proposal is reviewed or belongs to another source. Requires an account-linked API key. Shares a limit of 20 requests per account per 15 minutes with contacts. Returns 429 when the work limit is reached and 503 when the limiter is unavailable. These work-limit refusals do not count toward API usage quotas; other responses keep counting.

orgNumberstringrequired
domainstringrequired

min 1 chars, max 253 chars

200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
GET/api/valuation/{orgNumber}

Get indicative company valuation

Computes an indicative EV range using Damodaran industry multiples applied to the most recent filed financials. Returns 404 if insufficient financial data is available.

orgNumberstringrequired
200Successful response.
GET/api/enrichmentAPI key

Get domain enrichment status

Browse domain enrichment pipeline results - status, confidence, discovered domains and social handles per company.

statusstringoptional

Filter by enrichment status (e.g. 'confirmed', 'failed').

minConfidenceintegeroptional

Minimum confidence score (0–100).

≥ 0, ≤ 100

limitintegeroptional

Results per page. Max 200. Default 50.

≥ 1, ≤ 200

offsetintegeroptional

Pagination offset.

≥ 0, ≤ 9007199254740991

200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.
GET/api/job-categories

List job categories

Returns distinct active job category labels from current job postings. Use this to discover valid values for the `jobCategory` filter on `GET /api/companies`. Cached for 24 hours. No auth required.

200Successful response.
GET/api/updatesAPI key

Poll for updated companies

Returns companies updated since a given timestamp. Useful for incremental sync - poll periodically to keep a downstream store current. Cursor-paginated; follow nextCursor until hasMore is false.

sincestringrequired

ISO 8601 datetime - return companies updated at or after this point, e.g. 2026-01-01T00:00:00Z.

cursorstringoptional

Pagination cursor from a previous response's nextCursor field.

limitintegeroptional

Results per page. Default 20, max 100.

≥ 1, ≤ 200

200Successful response.
401Missing or invalid API key.
402Trial expired. Upgrade required.
429Rate limit or quota exceeded.