Export the period retention archive

Exports the period-sealed NF525 retention archive (JET, G4): the [from, to] window’s ticket signatures + closures anchored to the pre-window chain, plus the algorithm manifest and published public keys so an auditor re-verifies it OFFLINE. store (the chain id) and the ?from=/?to= UTC-day window (YYYY-MM-DD) are REQUIRED — a missing store or a missing/inverted window 400s.

GET /v1/fiscal/archive

Error

A valid request URL is required to generate request examples

200

{
  "version": "fa-v1",
  "chainId": "store-fiscal",
  "period": {
    "periodStart": "2026-07-16",
    "periodEnd": "2026-07-16"
  },
  "generatedAt": "2026-07-16T18:00:00.000Z",
  "signatureAnchor": "GENESIS",
  "closureAnchor": "GENESIS",
  "signatures": [
    {
      "id": "sig-1",
      "transactionId": "fx-1",
      "storeId": "store-fiscal",
      "total": 3600,
      "itemCount": 2,
      "chainId": "store-fiscal",
      "sequenceNumber": 1,
      "signedAt": "2026-07-16T09:30:00.000Z",
      "previousValue": "GENESIS",
      "algorithm": "hmac-sha256-v2",
      "value": "b1e2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"
    }
  ],
  "closures": [],
  "publicKeys": [],
  "algorithms": [
    "hmac-sha256-v2"
  ]
}

Authorizations

Authorization · string · header · required

Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.

Query Parameters

store · string

REQUIRED — the register chain id (per store). Missing → 400.

from · string

REQUIRED — inclusive window start (YYYY-MM-DD). Missing/inverted → 400.

to · string

REQUIRED — inclusive window end (YYYY-MM-DD, from <= to). Missing/inverted → 400.

Response

200

application/json

The self-describing period archive for offline re-verification.

The self-describing period archive for offline re-verification.

version · string · required

chainId · string · required

period · object · required

Show child attributes

generatedAt · string · required

signatureAnchor · string · required

closureAnchor · string · required

signatures · object[] · required

Show child attributes

closures · object[] · required

Show child attributes

publicKeys · object[] · required

Show child attributes

algorithms · string[] · required