Combined Tier 1 + Tier 2 company context
Returns the canonical view of a Norwegian organisation — public Brønnøysund-sourced Tier 1 fields (name, entity_type, NACE codes, status, municipality, role holders) plus the gated Tier 2 commercial metrics (employee_count, annual_turnover, total_assets) when the consumer has an active delegation for the org. The endpoint is cache-aware: a 24-hour freshness window keeps hot orgs cheap (_meta.served_from = 'cache'); beyond that the gateway fetches from Brønnøysund and upserts the result (_meta.served_from = 'live'). If Brønnøysund is unreachable AND the local cache is still within a 7-day hard cap, the gateway serves the stored row with _meta.stale = true so callers can reason about freshness; if the cache is absent or older than 7 days the endpoint returns 503 UPSTREAM_UNAVAILABLE. Tier 2 is null for every caller who does not already hold a delegation — data.tier_2_note (Norwegian) then points the caller at POST /api/v1/auth/system-user/delegate as the remediation path. data.aareg carries the NAV Aa-registeret aggregate block (active/full-time/part-time/freelance counts + employment types) when the consumer has the nav:aareg/v1/arbeidsforhold scope delegated; aggregate counts only — no individual identities. Independent of the commercial Tier 2 delegation: a consumer may hold one without the other.
Request
- Base URL: https://www.apier.no
- URL: https://www.apier.no/api/v1/company/{org}/context
- Auth: HTTP bearer
Path parameters
9-digit Norwegian organisation number (Brønnøysund-issued). Any other shape returns 400 VALIDATION_FAILED before the cache is touched.
Response
Company context served. Callers MUST branch on data.data_tier to know whether Tier 2 fields are available, and on _meta.served_from / _meta.stale to reason about freshness.
Example response
{
"data": {
"org_number": "999999999",
"name": "Eksempel AS",
"entity_type": "AS",
"nace_codes": [
"62.010"
],
"status": "active",
"municipality": "Oslo",
"signaturrett": [
{
"role": "Styreleder",
"name": "Ola Nordmann",
"rule": "Alene"
}
],
"prokura": [
{
"role": "Styreleder",
"name": "Ola Nordmann",
"rule": "Alene"
}
],
"mva_registered": true,
"has_filed_annual_accounts": true,
"last_accounts_year": 2024,
"board_members": [
{
"role": "Styreleder",
"name": "Ola Nordmann",
"rule": "Alene"
}
],
"tier_2": {
"employee_count": 42,
"annual_turnover": 10000000,
"total_assets": 5000000,
"mva_registered": true
}
},
"_meta": {
"rulebook_version": "v1.0.0",
"source": "apier.no",
"data_source": "Brønnøysund Enhetsregisteret + Apier Universal Rulebook",
"schema_version": "1.0.0",
"legal_basis": "NLOD — public registry reuse",
"response_timestamp": "2026-04-24T12:00:00.000Z",
"response_hash": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
"source_snapshot_id": "brreg-2026-04-24T02:00:00.000Z",
"cost_nok": 0.5,
"wallet_remaining_nok": 9.5,
"spend_cap_remaining_nok": 12.5
}
}Changes
No recorded changes to this operation across all 1 revision of this API.