Fields

All fields are required unless marked as nullable or optional.

• Nullable fields can return null.
• Optional fields can be omitted entirely from the response.

Types

• number
  Examples: 10, 10.52
• string
• object (See Common Types or individual resource definitions)
• boolean
• enum
  A predefined set of valid values

IDs

All resource IDs are in UUID format:

{
"id": "9dc2841d-602a-4c6c-ab38-0ed907921716"
}

Timestamps

Timestamps follow the Atom format and usually end with _at:

{
"createdAt": "2023-05-16T15:43:25+02:00",
"updatedAt": "2023-05-16T15:43:25+02:00"
}

Phone Numbers

Phone numbers must be in international format (E.164) with a leading + and country code. The number is validated against Google's libphonenumber database for the given country.

{
  "phone": "+421901234567"
}

Valid examples:

Country	Format
Slovakia	+421901234567
Czechia	+420601234567
USA	+12025551234
UK	+447911123456
Germany	+4915112345678

WARNING

Numbers without a country code (e.g., 0901234567) will be rejected.

Enums

Some fields (e.g., state or type) have predefined sets of values. Each resource section specifies its valid enums:

{
"state": "pending"
}