Company

Company verification verdict (pass / fail / unknown)

Returns a deterministic pass / warn / fail / unknown verification verdict for a Norwegian organisation, reduced from the SAME Tier 1 Brønnøysund data the /context endpoint already loads — no new upstream fetch on the read path (the open Regnskapsregisteret filing status is fetched + persisted on the /context + /verify refresh path and read back from the cached row). Computes seven live signals: is_active (registered status is ACTIVE), has_signing_authority_defined (a signaturrett, prokura, or innehaver holder is visible in the open role data; null when nothing is visible), not_bankrupt / not_under_dissolution / not_forcibly_dissolved (each the inverse of a RAW BRREG distress flag — konkurs / underAvvikling / underTvangsavviklingEllerTvangsopplosning — read per-flag, never the collapsed status), mva_registered (Tier-1 VAT status), and has_filed_annual_accounts (open Regnskapsregisteret filing status — see GET /accounts). Verdict: fail when not active; pass when active AND a signing-authority holder is visible; unknown when the status is indeterminate OR no signing authority is visible in the open role data (warn is reserved in the vocabulary and not emitted today). All transparency signals (distress, MVA, filing) NEVER change the verdict (a distress state already forces is_active: false → fail); any signal is null when its open-registry datum is genuinely unknown. _meta.served_from / _meta.stale reflect the underlying context cache state. Every successful call writes a company.verify audit_log row.

get/api/v1/company/{org}/verify

Request

  • Base URL: https://www.apier.no
  • URL: https://www.apier.no/api/v1/company/{org}/verify
  • Auth: HTTP bearer

Path parameters

orgstring required

9-digit Norwegian organisation number (Brønnøysund-issued). Any other shape returns 400 VALIDATION_FAILED before the cache is touched.

Response

Verification verdict computed. Branch on data.verification_status; inspect data.signals for the per-signal booleans (null where a signal is not yet derivable). _meta.served_from / _meta.stale describe the freshness of the underlying company data.

successtrue required

Example response

{
  "data": {
    "org_number": "999999999",
    "verification_status": "pass",
    "summary_en": "The company is actively registered in the Central Coordinating Register for Legal Entities (Enhetsregisteret) and has a registered signing authority (signaturrett), procuration (prokura) or owner (innehaver)."
  },
  "_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.