List a store's sealed closures

Lists a register chain’s sealed closures, ascending by sequence, optionally filtered by ?kind= (daily / monthly / annual). store (the chain id) is REQUIRED; without it the route 400s.

GET /v1/fiscal/closures

Error

A valid request URL is required to generate request examples

200

[
  {
    "id": "clo-1",
    "chainId": "store-close",
    "kind": "daily",
    "period": "2026-07-16",
    "periodStart": "2026-07-16",
    "periodEnd": "2026-07-16",
    "ticketCount": 2,
    "grossTotalCents": 7200,
    "grandTotalCents": 7200,
    "sequenceNumber": 1,
    "closedAt": "2026-07-16T18:00:00.000Z",
    "previousValue": "GENESIS",
    "algorithm": "hmac-sha256-v2",
    "value": "c2f3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3"
  }
]

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.

kind · enum<string>

Closure kind: an optional list filter, but REQUIRED to select one closure.

Available options: daily, monthly, annual

period · string

Period key matching the kind (YYYY-MM-DD / YYYY-MM / YYYY). REQUIRED to select one closure.

Response

200

application/json

The store's sealed closures, ascending by sequence number.

id · string · required

chainId · string · required

kind · enum<string> · required

Available options: daily, monthly, annual

period · string · required

periodStart · string · required

periodEnd · string · required

ticketCount · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

grossTotalCents · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

grandTotalCents · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

sequenceNumber · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

closedAt · string · required

previousValue · string · required

algorithm · string · required

value · string · required

Example:

[
  {
    "id": "clo-1",
    "chainId": "store-close",
    "kind": "daily",
    "period": "2026-07-16",
    "periodStart": "2026-07-16",
    "periodEnd": "2026-07-16",
    "ticketCount": 2,
    "grossTotalCents": 7200,
    "grandTotalCents": 7200,
    "sequenceNumber": 1,
    "closedAt": "2026-07-16T18:00:00.000Z",
    "previousValue": "GENESIS",
    "algorithm": "hmac-sha256-v2",
    "value": "c2f3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3"
  }
]