Currency & Time

VanityPass follows international standards for currency and time representation.

Currency Codes

All prices and amounts use ISO-4217 codes (3-letter uppercase):

• USD — US Dollar
• EUR — Euro
• GBP — British Pound
• JPY — Japanese Yen
• (and 100+ others)

Example:

{
  "price": 1500,
  "currency": "USD",
  "totalUSD": 1500
}

To convert between currencies, use the /v1/fx/rates and /v1/fx/convert endpoints.

Timestamps

All timestamps are ISO-8601 format in UTC:

2026-06-24T13:45:30Z

• Z suffix indicates UTC (no timezone offset needed).
• All datetimes are server-side UTC, regardless of user location.
• Clients should convert to local timezone for display.

Example:

{
  "bookingId": "...",
  "createdAt": "2026-06-24T13:45:30Z",
  "expiresAt": "2026-06-25T13:45:30Z"
}

Dates (without time)

Date-only fields use ISO-8601 date format (no time):

2026-06-24

Used for:

• Hotel check-in/check-out dates
• Travel itinerary dates
• Birthday fields

Conversions

JavaScript:

const utcDate = new Date('2026-06-24T13:45:30Z');
const localDate = utcDate.toLocaleString(); // Adapts to user timezone

Python:

from datetime import datetime
utc_time = datetime.fromisoformat('2026-06-24T13:45:30+00:00')
print(utc_time)  # Renders in local timezone