Subscriptions

List active webhook subscriptions

Lists active subscriptions for the calling consumer. Secret material (hash AND ciphertext) is never returned in any form — only metadata. Inactive subscriptions are not included.

get/api/v1/subscriptions

Request

  • Base URL: https://www.apier.no
  • URL: https://www.apier.no/api/v1/subscriptions
  • Auth: HTTP bearer

Query parameters

limitinteger

Accepted for forward compatibility but IGNORED at v1. The handler always returns up to the active-subscription hard cap (10) — silently truncating with a ?limit=1 request would leave the remaining rows unreachable. The validator still rejects out-of-range values so generated clients fail-fast on bad input. Will become meaningful when active-subscription caps rise and pagination is added.

Response

All active subscriptions belonging to the caller. Not paginated — the per-consumer cap of 10 ensures the response always fits in one page.

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.