nextCursor.
Locations
locationType:
Listing locations
The list returns active locations only. Deleted locations never appear.namePrefix without locationType is a 400 VALIDATION_ERROR, and the
message says namePrefix requires locationType.
Display nameI18n in the reader’s language when it is present, and fall back
to name. timezone is the zone a booking at this location is shown in. When
it’s null, the supplier’s zone and then the project’s apply. See
Timezones.
A TRAVEL_ZONE row carries its geometry: travelZoneType, then
travelDistance and travelDistanceUnit for a circle, or travelRegions
(GeoJSON) for a drawn area. Those fields are null on the other types.
Reading one location
GET /locations/{locationId} returns one location, active or inactive. Use
it to show where a booking takes place: a booking at a venue that has since
closed still resolves.
A deleted location, an unknown id and another project’s location all return the
same 404 NOT_FOUND.
A supplier’s own travel zones (
stz_…) are not project locations, and are not
returned here. A supplier manages them on the
supplier plane.The supplier’s venue list
A supplier portal has a narrower list of its own:GET /v1/projects/{projectId}/suppliers/me/locations. It returns the project’s
active PHYSICAL and VIRTUAL locations, sorted by name — the venues a
supplier can name in a schedule — without travel settings, status or audit
fields. It takes the supplier’s user token as well as the API key. See
Supplier portal: availability.
Skills
- build the skill picker of a supplier profile form — the ids you send as
skillIdstoPATCH /suppliers/mecome from here; - filter availability by skill — the
skillsfield onPOST /availability/searchtakes these ids.
ordinal. Add includeInactive=true
for the inactive ones too; they come first. Soft-deleted skills never appear.
Display nameI18n in the reader’s language, falling back to name.
To add a skill to a supplier with the API key, use
POST /v1/projects/{projectId}/suppliers/{supplierId}/skills/{skillId}. See
Suppliers.
Errors
Endpoint index
GET /v1/projects/{projectId}/locationsGET /v1/projects/{projectId}/locations/{locationId}GET /v1/projects/{projectId}/skillsGET /v1/projects/{projectId}/suppliers/me/locations