Error
Instruments
Get an instrument by id (carte cadeau)
Returns one instrument’s back-office read model, addressed by the INTERNAL id (not the bearer code). Reach for this when you already hold an id from the listing or from an issuance; if all you have is a scanned card, use the by-code lookup. 404s when no instrument carries the id.
GET
Error
Authorizations
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.
Path Parameters
The internal instrument id to act on (not the bearer code).
Minimum string length:
1Response
The instrument read model.
The instrument read model.
Minimum string length:
1Minimum string length:
1Available options:
gift_card, credit_note, store_credit Required string length:
3Required range:
0 <= x <= 9007199254740991Required range:
0 <= x <= 9007199254740991Available options:
active, depleted, void Minimum string length:
1Pattern:
^(?:(?:\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))$
