List reservations

GET /reservations/get/

What It Does

Read reservations for synchronization, reporting, or a customer-facing account area.

Authentication

Requires an API token with the read scope. Send it as a bearer token or with the configured API key header.

Parameters

Name	Location	Required	Type	Description
full	query	No	boolean	Include stored data properties.
past	query	No	boolean	Include past reservations.
customers	query	No	string	Comma-separated customer IDs.
services	query	No	string	Comma-separated service IDs.
providers	query	No	string	Comma-separated provider IDs.
status	query	No	enum(pending, confirmed, cancelled)	Current reservation status.

Request Body

This endpoint does not require a JSON request body.

Responses

Status	Meaning	Description	Body
200	Success	Reservations	OkEnvelope + object
401	Authentication required	Missing or invalid API token	WpRestError

Request Example

curl -X GET "https://example.com/wp-json/thebooking/v1/API/reservations/get/?full=true&past=true&customers=value&services=service_123&providers=123&status=value" \
  -H "Authorization: Bearer $TBK_API_TOKEN"

Success Response Example

{
  "status": "OK",
  "response": [
    {
      "id": "resource_123",
      "serviceId": "service_123",
      "customerId": "customer_123",
      "providerId": 123,
      "start": 1779148800,
      "end": 1779152400,
      "status": "pending"
    }
  ]
}