Scalars
Primitive scalar types used across Decal's API — DateTime, FiatCurrency, CurrencyAmount, and other value types.
Scalar types represent single primitive values. These types appear throughout Decal's API in request and response fields.
DateTime
An ISO 8601 datetime string, always in UTC, with millisecond precision.
YYYY-MM-DDTHH:mm:ss.sssZExample: 2026-04-15T10:00:00.000Z
All DateTime values in Decal's API are returned as UTC strings. When parsing, treat the Z suffix
as UTC (+00:00).
FiatCurrency
A three-letter ISO 4217 code for a government-issued currency. This is the currency an order is priced and charged in, never a stablecoin such as USDC. Decal currently accepts:
| Code | Currency |
|---|---|
USD | US dollar |
GBP | Pound sterling |
Codes are case-insensitive on input (gbp is accepted) and always returned upper-case. Any other
code returns 400 with code: "VALIDATION_ERROR".
CurrencyAmount
An integer representing a monetary value in the smallest unit of a FiatCurrency
(e.g. cents for USD, pence for GBP).
| Amount | CurrencyAmount |
|---|---|
| $1.00 | 100 |
| $4.50 | 450 |
| £4.50 | 450 |
| $12.99 | 1299 |
Never pass a decimal. 1 means one cent ($0.01), not one dollar. All CurrencyAmount fields in
Decal's API use this convention for both inputs and outputs.