Admin

Create a new API key

Generates a new API key for the specified consumer. The plaintext key is returned ONCE in the response — after this, only the SHA-256 hash exists in the database. Maximum 3 active keys per consumer. This operation is recorded in the append-only audit log.

post/api/v1/admin/keys

Request

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

Request body

consumer_idstring uuid required

The consumer to create a key for.

labelstring

Optional human-readable label for the key.

Response

API key created. The plaintext key is included ONCE.

successtrue

Always true on success.

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.