Hermos API
Concepts

Money and timestamps

Integer minor units and UTC time values.

Money is an object with an integer amount in minor currency units and a currency string containing three lower-case letters. The contract describes this as a lower-case ISO 4217 currency code; validation checks the shape, not membership in a currency registry. Amounts must be safe JavaScript integers, from −9007199254740991 to 9007199254740991. The shared schema allows negative values; any operation-specific restrictions belong to its endpoint.

{ "amount": 1250, "currency": "usd" }

For USD, this example represents 12.50 dollars. Send integer minor units, not floating-point major currency values. The money object rejects extra fields.

Timestamps use RFC 3339 UTC strings with the Z suffix. Offset suffixes such as +00:00 are not accepted. Fractional seconds are allowed.

2026-10-01T00:00:00Z

Public money resource endpoints are not yet available in the current route set.