How do Amelia API timeslots endpoints work

Use the timeslots endpoint to retrieve available booking timeslots for a service based on duration, number of persons, and optional filters like employees, location, extras, and rescheduling rules.

You can review all endpoints and examples in the Amelia API Postman collection.

API endpoints are available only in Elite license plans. Using the API requires coding skills and is not covered by standard plugin support.

How do I call the get timeslots endpoint?

Use this endpoint to retrieve available timeslots for a specific service configuration.

Method: GET
Path: /slots

Base path

{{your_site_URL}}/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1

Authorization

All Amelia endpoints use API key authorization via a request header named Amelia.

Required properties

serviceId (integer); service ID
persons (integer); number of persons

Other properties

providerIds (array); array of employee IDs
locationId (integer); location ID
serviceDuration (integer); service duration in seconds
startDateTime (string); from which date to retrieve timeslots, string in datetime format YYYY-MM-DD HH:mm
endDateTime (string); up until which date to retrieve timeslots, string in datetime format YYYY-MM-DD HH:mm
excludeAppointmentId (integer); do not include this appointment ID in the timeslot calculation, used when an appointment is being rescheduled
extras (array); an array of extras, since they can affect the timeslots

Example

Request

				
					curl --location 'https://example-site.com/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/slots&locationId=2&serviceId=3&serviceDuration=1800&providerIds=3&persons=1&startDateTime=2026-02-10%2009:00&extras=[]&excludeAppointmentId=null' \
--header 'Amelia: YOUR_API_KEY'

Response

				
					{
  "message": "Successfully retrieved free slots",
  "data": {
    "minimum": "2026-02-10 09:00",
    "maximum": "2026-04-10 09:00",
    "slots": {
      "2026-03-02": {
        "08:30": [[3, 2]],
        "09:00": [[3, 2]],
        "09:30": [[3, 2]],
        "10:00": [[3, 2]],
        "10:30": [[3, 2]],
        "11:00": [[3, 2]]
      },
      "2026-03-09": {
        "07:00": [[3, 2]],
        "07:30": [[3, 2]],
        "08:00": [[3, 2]],
        "08:30": [[3, 2]]
      },
      "2026-03-16": {
        "07:00": [[3, 2]],
        "07:30": [[3, 2]],
        "08:00": [[3, 2]],
        "08:30": [[3, 2]]
      }
    },
    "occupied": {
      "2026-02-12": {
        "07:00": [[3, 4, 0, 6]],
        "08:00": [[3, 4, 0, 6]],
        "09:30": [[3, 4, 0, 2]],
        "11:30": [[3, 4, 0, 6]]
      },
      "2026-02-26": {
        "13:00": [[3, 1, 0, 2]]
      },
      "2026-03-02": {
        "07:30": [[3, 1, 0, 1]]
      }
    },
    "busyness": {
      "2026-03-02": 7,
      "2026-03-09": 0,
      "2026-03-16": 0
    },
    "lastProvider": null
  }
}