Discovery

Machine-readable capability manifest (agent discovery)

Zero-auth, deterministic, cacheable for 1 hour. The agent-first counterpart to this OpenAPI spec: where OpenAPI describes HTTP shapes for humans + tool-generators, /v1/capabilities describes WHAT the agent can accomplish at a planning level and pairs each capability with the matching openapi_operation_id so the agent can jump into this spec for full signature details.

The manifest is a hand-curated typed constant, NOT auto-derived from route files — that would over-share (internal health checks, cron endpoints) and drift on refactors. Every new public or authenticated endpoint adds an entry here. Capability id values and endpoint paths are APPEND-ONLY forever; renaming either is a /v2 break. Agents may cache the response keyed by id.

The top-level rulebook_version field carries the active Rulebook version and advances in lockstep with _meta.rulebook_version whenever the Rulebook is updated.

Categories: public-tool (zero-auth discovery / utility), company-data (authenticated org reads), auth (Altinn delegation broker + approval tokens), admin (operator-only, behind ADMIN_API_KEY), discovery (this endpoint's siblings). auth: "none" entries need no Authorization header; auth: "api_key" entries need the Bearer consumer key. tier_minimum names the lowest consumer tier that may call a capability (null when auth is none or when the route is admin-only).

Rate-limited at 1000/min per IP via the shared public wrapper.

get/api/v1/capabilities

Request

  • Base URL: https://www.apier.no
  • URL: https://www.apier.no/api/v1/capabilities
  • Auth: none required

Response

Full manifest.

successtrue required

Example response

{
  "data": {
    "version": "1",
    "rulebook_version": "1.0.0",
    "capabilities": [
      {
        "id": "public.deadlines",
        "endpoint": {
          "path": "/api/v1/public/deadlines"
        }
      }
    ],
    "sandbox": {
      "simulate_error_param": "?simulate_error=<missing_delegation|invalid_token|validation_error|scope_missing>"
    }
  },
  "_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.