Embed verification in your onboarding flow

The job

You run a platform onboarding business customers and want to surface a verification verdict in your own UI — without building a registry engine yourself.

Endpoint

• GET /api/v1/company/{org}/verify

Request

curl -H 'Authorization: Bearer <API_KEY>' \
  https://www.apier.no/api/v1/company/999999999/verify

Embed-friendly projection

{
  "org_number": "999999999",
  "verification_status": "pass",
  "signals": {
    "is_active": true,
    "not_bankrupt": true,
    "has_signing_authority_defined": true,
    "has_filed_annual_accounts": true
  },
  "summary": "Organisasjonen er registrert og aktiv, med definert signaturrett.",
  "checked_at": "2026-06-16T06:00:00.000Z"
}

Store the flat projection above, not the whole response — it is small, stable and safe to render in an onboarding UI. Treat each signal as tri-state: true / false / null (unknown).

Next steps

• Cache the verdict briefly (minutes, not days) and re-verify on the next session — registry status changes.
• Show a “needs attention” state when a key signal is false or null, rather than hard-blocking.