Error

A valid request URL is required to generate request examples

[
  {
    "id": "corr-9a02:ageVerification:sale-58:2026-07-16T18:12:00.000Z",
    "operatorId": "user-camille",
    "transactionRef": "sale-58",
    "at": "2026-07-16T18:12:00.000Z",
    "outcome": "block"
  },
  {
    "id": "corr-8f21:ageVerification:sale-42:2026-07-16T09:00:00.000Z",
    "operatorId": "user-camille",
    "transactionRef": "sale-42",
    "at": "2026-07-16T09:00:00.000Z",
    "outcome": "pass"
  }
]

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "statusCode": 123,
    "fieldErrors": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

Compliance

List age-verification attestations

Reads the durable age-verification compliance trail (justificatif de contrôle d’âge) — the append-only legal record that a restricted-item check was performed. Reach for this to produce the evidence a regulator asks for, or to audit a given transaction or operator. Every facet is OPTIONAL and combined as AND: transactionRef (one sale), operatorId (one cashier), outcome (pass/block/needs_check), and the inclusive instant range from/to (ISO-8601). With no filter it returns the WHOLE trail, ordered newest-first. The rows carry NO customer identity — by construction the trail cannot hold a date of birth, name or document number. There is deliberately no store filter (the row has no store column). Gating: the router rides the till scope pos.checkout.operate.

GET

age-attestations

Error

A valid request URL is required to generate request examples

[
  {
    "id": "corr-9a02:ageVerification:sale-58:2026-07-16T18:12:00.000Z",
    "operatorId": "user-camille",
    "transactionRef": "sale-58",
    "at": "2026-07-16T18:12:00.000Z",
    "outcome": "block"
  },
  {
    "id": "corr-8f21:ageVerification:sale-42:2026-07-16T09:00:00.000Z",
    "operatorId": "user-camille",
    "transactionRef": "sale-42",
    "at": "2026-07-16T09:00:00.000Z",
    "outcome": "pass"
  }
]

{
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "<string>",
    "statusCode": 123,
    "fieldErrors": [
      {
        "field": "<string>",
        "message": "<string>"
      }
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

{
  "error": {
    "message": "<string>",
    "statusCode": 123
  }
}

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

transactionRef

string

Filter to the check(s) recorded for one transaction/ticket reference.

Minimum string length: 1

operatorId

string

Filter to the checks a single operator (cashier) recorded.

Minimum string length: 1

outcome

enum<string>

Filter to one decision: pass, block or needs_check.

Available options:

pass,

block,

needs_check

from

string<date-time>

Inclusive lower bound on the instant (at >= from).

Minimum string length: 1

string<date-time>

Inclusive upper bound on the instant (at <= to).

Minimum string length: 1

Response

The matching attestations, newest first (empty array when none match).

string

required

operatorId

string

required

transactionRef

string

required

string<date-time>

required

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

outcome

enum<string>

required

Available options:

pass,

block,

needs_check

Example:

[
  {
    "id": "corr-9a02:ageVerification:sale-58:2026-07-16T18:12:00.000Z",
    "operatorId": "user-camille",
    "transactionRef": "sale-58",
    "at": "2026-07-16T18:12:00.000Z",
    "outcome": "block"
  },
  {
    "id": "corr-8f21:ageVerification:sale-42:2026-07-16T09:00:00.000Z",
    "operatorId": "user-camille",
    "transactionRef": "sale-42",
    "at": "2026-07-16T09:00:00.000Z",
    "outcome": "pass"
  }
]

Query the central audit log Record an age-verification attestation

Ventes & encaissement

Catalogue & stock

Finance

Clients & fidélité

Marketing & promotions

Services

Système

Other

List age-verification attestations

Authorizations

Query Parameters

Response