How do I search timeslots with the Amelia API for the search form

Use the search timeslots endpoint to retrieve available services for a specific date, optionally filtered by services, providers, location, time range, paging, and sorting.

You can find more API examples in the Amelia API Postman collection you can download here.

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 search timeslots endpoint?

Use this endpoint to search for available services and related availability data for a selected date in the timeslots search form flow.

Method: GET
Path: /search

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

date (string); the date to search for timeslots, in YYYY-MM-DD format

Other properties

services (array); array of service IDs
providers (array); array of provider IDs
location (integer); location ID
timeFrom (string); time from which to search, in HH:mm:ss format
timeTo (string); time until which to search, in HH:mm:ss format
page (integer); page number
sort (string); sorting mode, possible values: name or price, an empty value sorts services by their backend position

Example

Request

				
					curl --location 'https://example-site.com/wp-admin/admin-ajax.php?action=wpamelia_api&call=/api/v1/search&date=2026-03-18&location=2&page=1&services=1,2&sort=name&providers=1,3' \
--header 'Amelia: YOUR_API_KEY'

Response

				
					{
  "message": "Successfully retrieved searched services.",
  "data": {
    "providersServices": [
      {
        "1": 1,
        "places": null,
        "locations": [
          2
        ],
        "price": 23
      },
      {
        "2": 1,
        "places": null,
        "locations": [
          2
        ],
        "price": 0
      }
    ],
    "total": 2
  }
}