Search First Available Time

Returns the first date, from start_date, on which the lane has at least one available start
time, together with that earliest start time broken down per service: "the soonest this can be
done".

Important Notes

  • Requires available_slots:read scope (it is a read, sent as POST because it carries a body).
  • Same body and same rules as POST /v3/availability (lane, providers, clock-aligned start
    times, dates_and_providers, minimum notice).
  • services takes at most 10 items; a longer lane answers 400 max_services_exceeded before
    any search.
  • Dates are searched one by one up to the company's booking window (at most 365 days). When none
    is found the answer is 200 with available: false and date and time null.
  • time has the shape of one entry of times in POST /v3/availability.

Errors Dictionary

Same as POST /v3/availability.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer
required
date
required

Date to search (POST /v3/availability) or first date to try (first_available).

services
array of objects
required
length between 1 and 10

The lane, in booking order.

services*
integer
required
integer | null

Only this provider for this service. Omitted or null, any eligible provider.

dates_and_providers
array of objects

Times to treat as busy for a provider (for example, held for another lane).

dates_and_providers
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json