Discovery

Machine-readable price list for every metered endpoint and MCP tool

Public, zero-auth price discovery — call this FIRST, before any paid call, to learn what every metered endpoint and MCP tool costs. Derived from the SAME pricing configuration the 402 INSUFFICIENT_CREDITS meter enforces, so there is deliberately no second price table anywhere in the system; a previously fetched price can still become stale after a pricing change, and the per-call metered response remains the authoritative charging signal. Returns each metered endpoint's canonical path, HTTP method, pricing category and cost in whole øre (100 øre = NOK 1), the matching MCP tool name where one exists, the credit-unit convention, whether enforcement is currently live (while dark, metered calls are not charged and responses carry X-Credit-Check: shadow), the exact machine-readable recovery contract a 402 carries (top_up_url / balance_ore / cost_ore plus the catalog-derived retryable / fix_hint / docs_url), the balance-visibility surfaces (X-Credits-* response headers on REST, metadata.credits on MCP, and the authenticated /account/credits/balance self-read), the low-balance warning rule, and the top-up bounds with the billing-dashboard top_up_url. Prices ONLY — never balances, customer data, or any authenticated state; the endpoint is keyless by design so an agent can price a workflow before holding a key. Served fresh on every request: Cache-Control no-store (the body embeds the runtime enforcement.live mode, which must never be served stale from a shared cache) with a strong SHA-256 ETag honouring If-None-Match (304) — revalidation is answered at origin over the current body, so a 304 can never confirm a stale enforcement mode. The per-call metered response (X-Credit-Check / X-Credits-* headers, or a 402 body) is the authoritative charging signal; enforcement.authority_note states this in-band.

get/api/v1/pricing

Request

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

Response

The current price list. Deterministic for a given pricing configuration: same config, same price data — data_freshness/last_verified are PINNED to the pricing configuration's change stamp, and the ETag is computed over that stable representation (per-call wire markers like response_timestamp/response_hash are excluded from the ETag hash domain — the convention every cached read endpoint shares).

successtrue required

Example response

{
  "_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.