FacilityUse By-ID

Note

The root ids returned in an upcoming-slots query parameter search form the basis of the FacilityUse ByID search.

Every FacilityUse will have a root id, which will be a URL that looks like https://search.imin.co/facilities-api/v2/facility-uses/{identifier}. This should be used to make FacilityUse By-ID searches, which will return all availableSlots for a specific FacilityUse for up to 7-days in the future from today’s date.

Tip

FacilityUse By-ID searches return slots for one facility over multiple days: one facility + multiple days + slots.

When the FacilityUse ByID-route is used, you will be presented with a list of Slot ids, each contained within the event array. You can use these event[].ids to make a Slot ByID search.

Tip

The recommended use for the ByID endpoint is in a timetable view. In terms of the user journey, it is recommended that this endpoint is used when a person has found a facility they wish to use (via a query parameter search) and now want to check for available Slots over the next week/on a specific day.