Skip to main content
GET
/
wp-json
/
latepoint-api
/
v1
/
bookings
List Bookings
curl --request GET \
  --url https://api.example.com/wp-json/latepoint-api/v1/bookings \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "data": [
    {
      "id": 123,
      "booking_code": "<string>",
      "status": "<string>",
      "start_date": "<string>",
      "start_time": "<string>",
      "end_time": "<string>",
      "duration": 123,
      "price": "<string>",
      "customer": {
        "id": 123,
        "first_name": "<string>",
        "last_name": "<string>",
        "email": "<string>",
        "phone": "<string>"
      },
      "payment_status": "<string>",
      "agent": {
        "id": "<string>",
        "full_name": "<string>",
        "email": "<string>",
        "phone": "<string>"
      },
      "service": [
        {}
      ],
      "location": {
        "id": "<string>",
        "name": "<string>",
        "full_address": "<string>",
        "category": [
          {}
        ]
      },
      "total_attendees": 123,
      "notes": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>"
    }
  ],
  "pagination": {
    "page": 123,
    "per_page": 123,
    "total": 123,
    "total_pages": 123,
    "has_next_page": true,
    "has_previous_page": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs-restapi.wplimit.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Description

This endpoint allows you to retrieve a list of all bookings in your LatePoint system. It includes advanced filtering, search, and pagination options to efficiently handle large volumes of data.

​
Authentication

​
X-API-Key
string
required
Your LatePoint API key. You can get it from the admin panel.

​
Query Parameters

​
Pagination

​
page
integer
default:"1"
Page number for pagination
​
per_page
integer
default:"20"
Number of bookings per page (max 100)

​
Basic Filters

​
status
string
Filter by booking status (pending, confirmed, cancelled, completed)
​
customer_id
integer
Filter by customer ID
​
agent_id
integer
Filter by agent ID
​
service_id
integer
Filter by service ID
​
location_id
integer
Filter by location ID

​
Date Filters

​
date_from
string
Filter bookings from this date (YYYY-MM-DD format)
​
date_to
string
Filter bookings until this date (YYYY-MM-DD format)
​
created_date_from
string
Filter by creation date from (YYYY-MM-DD format)
​
created_date_to
string
Filter by creation date until (YYYY-MM-DD format)

​
Dynamic Filters

​
booking_code
string
Filter by booking code (partial match supported)
​
payment_status
string
Filter by payment status
​
duration_min
integer
Filter bookings with minimum duration (in minutes)
​
duration_max
integer
Filter bookings with maximum duration (in minutes)
​
price_min
number
Filter bookings with minimum price
​
price_max
number
Filter bookings with maximum price
​
customer_email
string
Filter by customer email (partial match supported)
​
customer_phone
string
Filter by customer phone (partial match supported)

​
Metadata Filters

​
include_meta
boolean
default:"false"
Include booking metadata in response
​
meta_key
string
Filter by specific metadata key (requires meta_value)
​
meta_value
string
Filter by metadata value (requires meta_key, partial match supported)

​
Search and Sorting

​
search
string
Search in customer name, email, or booking code
​
sort
string
default:"start_date"
Sort field (start_date, created_at, customer_name, status, id)
​
order
string
default:"desc"
Sort order (asc, desc)

​
Response

​
success
boolean
Always true on success
​
data
array
Array of booking objects
​
pagination
object
Pagination information

​
Examples

​
Basic Request

curl -X GET "https://your-site.com/wp-json/latepoint-api/v1/bookings" \
  -H "X-API-Key: YOUR_API_KEY"

​
Filter by Status and Date

curl -X GET "https://your-site.com/wp-json/latepoint-api/v1/bookings?status=approved&date_from=2024-01-01&date_to=2024-01-31" \
  -H "X-API-Key: YOUR_API_KEY"

​
Search by Customer Name or Code

curl -X GET "https://your-site.com/wp-json/latepoint-api/v1/bookings?search=john&sort=start_date&order=asc" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

{
  "success": true,
  "data": [
    {
      "id": 55,
      "booking_code": "M3DELUX",
      "status": "approved",
      "start_date": "2026-04-29",
      "start_time": "13:00",
      "end_time": "14:00",
      "duration": 60,
      "price": "23.00",
      "payment_status": "",
      "customer": {
        "id": 2,
        "first_name": "John",
        "last_name": "Doe",
        "email": "john@example.com",
        "phone": "+11111111111"
      },
      "agent": {
        "id": "1",
        "full_name": "Pao Campo",
        "email": "pao@example.com",
        "phone": ""
      },
      "service": [],
      "location": {
        "id": "1",
        "name": "Main Location",
        "full_address": "",
        "category": []
      },
      "notes": "",
      "created_at": "2026-04-26 06:14:48",
      "updated_at": "2026-04-26 06:14:48",
      "total_attendees": 1
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 21,
    "total_pages": 2,
    "has_next_page": true,
    "has_previous_page": false
  }
}

​
Error Responses

Error 401 - Unauthorized
{
  "code": "rest_forbidden",
  "message": "Unauthorized",
  "data": { "status": 401 }
}
Error 503 - LatePoint not available
{
  "code": "latepoint_not_available",
  "message": "LatePoint is not available or has not loaded correctly",
  "data": { "status": 503 }
}

​
Important Notes

Performance: For better performance, use specific filters instead of fetching all bookings and filtering on the client side.
Rate Limiting: This endpoint is subject to rate limiting. Check response headers to monitor your usage.
Pagination: To get all bookings, use the has_next_page field in the response to determine if more pages are available.

​
Common Use Cases

​
1. Today’s Bookings Dashboard

// Get today's bookings sorted by start time
const today = new Date().toISOString().split('T')[0];
const response = await fetch(`/wp-json/latepoint-api/v1/bookings?date_from=${today}&date_to=${today}&sort=start_date&order=asc`, {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
if (data.success) console.log(data.data);

​
2. Customer History

// Get all bookings for a specific customer
const response = await fetch(`/wp-json/latepoint-api/v1/bookings?customer_id=45&sort=start_date&order=desc`, {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
if (data.success) console.log(data.data);

​
3. Monthly Report

// Get current month's bookings
const firstDay = new Date(new Date().getFullYear(), new Date().getMonth(), 1).toISOString().split('T')[0];
const lastDay = new Date(new Date().getFullYear(), new Date().getMonth() + 1, 0).toISOString().split('T')[0];
const response = await fetch(`/wp-json/latepoint-api/v1/bookings?date_from=${firstDay}&date_to=${lastDay}&status=approved`, {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
if (data.success) {
  console.log(`Total bookings: ${data.pagination.total}`);
  console.log(data.data);
}