Skip to main content

Get next available slots

Method GET​

https://my.easyweek.io/api/public/v2/locations/{location_uuid}/time-slots/next

This endpoint retrieves the next available time slots for a selected service and staff member at a specific location. It can be used to quickly find upcoming slots for scheduling without searching through the full range of dates.

Example Request​

curl -i -X GET \
  https://my.easyweek.io/api/public/v2/locations/{location_uuid}/time-slots/next?service_uuid={service_uuid}&staffer_uuid={staffer_uuid}&timezone={timezone} \
  -H 'Authorization: Bearer <YOUR_SECRET>' \
  -H 'Workspace: <YOUR_WORKSPACE>'

Path Parameters​

  • location_uuid (string, required): This parameter signifies the unique identifier of the location from which you wish to query the next available time slots.

Query Parameters​

  • service_uuid (string, required): The UUID of the service for which time slot availability is being requested.
  • staffer_uuid (string, optional): This parameter represents the individual staff member's UUID for whom the time slot availability is being checked.
  • timezone (string, optional): Represents the timezone identifier for the client's local timezone. Used to adjust the time slots to the client's local time.

Example Response​

{
  "data": [
    {
      "timezone": "Europe/Berlin",
      "currency": "EUR",
      "dates": [
        {
          "date": "2023-12-20",
          "slot": {
            "start": "13:40",
            "end": "14:10",
            "start_formatted": 49200,
            "end_formatted": 51000,
            "price": 10000,
            "price_formatted": "€100.00",
            "staffers": [
              {
                "uuid": "eac5a506-69c0-40c4-8758-85c501d26bcb"
              }
            ]
          }
        }
      ]
    }
  ]
}