Skip to navigation

IDs, time, and money

View as Markdown

ID glossary

PrefixMeaningRule
crs_Inventory CourseRediscover for the selected organization
ttm_Tee TimeTreat as an opaque Reservation/availability reference
off_Availability offerUse unchanged before its five-minute expiry
res_ReservationUse for retrieve and cancellation
cur_Page cursorReturn unchanged with identical filters and limit
req_Request IDLog and provide to support

These values are encrypted or otherwise opaque, authenticated, and versioned. Length and internal format are not contractual. Never parse, synthesize, compare prefixes for authorization, or substitute database/legacy IDs.

Time

time.local_date and time.local_time are the guest-facing wall clock values in time.timezone, an IANA zone. time.starts_at is the canonical UTC instant. Use local fields for display and the UTC instant for ordering and integrations. Do not derive one by attaching a fixed offset: daylight-saving rules can change.

Availability date and time filters are course-local. Every allocation in a multi-allocation Reservation must share one course-local date, and allocations are returned in canonical start order.

Money

Money.amount_minor is an integer in the currency’s minor unit; currency is an uppercase ISO 4217 code. For USD, 10300 means $103.00. Never use binary floating point for totals.

All v1 Public API Reservations are Pay at Course. Prices are the accepted snapshot, but Trutee collects no amount through this API and cannot collect cancellation fees.