Skip to main content
Many endpoints accept numeric IDs (startTimeTypeId, itemColorId, statusId, pickupMethodId, venueTypeId, and so on) or string enums. This page collects the valid values.
You can now read most of these from the API instead of hardcoding them. GET /v1/reference/types returns 24 of these lookup tables in a single call, always current. This page remains useful for the meaning behind each value — the semantics of a time type, or which item types count as travel — which the API returns only as labels.
Unless noted otherwise, the values below were verified against the live API by creating records across each ID range and reading back the resolved labels. Items the API does not expose are marked Not verifiable via the API and need backend confirmation.

​
Schedule

​
Item types (type)

Confirmed. Types 2–6 are travel items and require an origin.

​
Time types (startTimeTypeId / endTimeTypeId)

Confirmed. The time type anchors the time to a day relative to the schedule item’s own day — e.g. a “lobby call tomorrow” line shown on today’s day uses day_after.

​
Item colors (itemColorId)

Confirmed (1–20). Colors follow a Tailwind-style palette. * ID 11 resolves to red (a duplicate of 2) — likely a seed-data quirk (TO BE FIXED).

​
Status types (statusTypeId)

Confirmed. The same values apply to the venue statusTypeId field (both resolve against the same backend table).

​
Reminder types (reminder[].typeId)

Confirmed (from backend seed data). The reminder’s duration is a count of the chosen unit — e.g. { "typeId": 2, "duration": 3 } fires 3 hours before the item.

​
Travel types (traveltype)

Confirmed (from backend seed data). The travel mode for travel items (item types 2–6) — distinct from the item type itself.

​
Guest list

​
Pickup methods (pickupMethodId)

Confirmed (from backend seed data). Required when adding a guest. Note: the guest-list GET response does not return the pickup method, so the value cannot be read back through the API.

​
Statuses (statusId)

Confirmed.

​
Venues

​
Venue types (venueTypeId)

Confirmed (1–32). * ID 2 returns an empty label (-) — a deprecated/placeholder row

​
Age restrictions (ageRestrictionId)

Confirmed (from backend seed data).

​
Venue categories (venueCategoryId)

Confirmed. A valid venueCategoryId is required to create a venue — omitting it or sending an unknown ID causes the create to fail.

​
Accommodation

​
Types (type)

​
Shared

​
Avatar colors (avatarColorId)

Confirmed (from backend seed data). Used on tour create (avatarColorId) and guest list entries. Identical palette to Item colors, including the duplicate red at ID 11.

​
User & organization roles

Confirmed (from backend seed data). Role IDs/names appear under several keys (loggedInUserRole, user_role_type, user_role) and the naming varies by context, but the underlying IDs are:
Only org_admin can create or edit tours and edit organization information. tour_admin and tour_member operate only on the entities inside a tour — schedule items, venues, accommodation, guest list, and bulletins — not on the tour record itself or on org settings.