List Bookings - REST API for Latepoint

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
  }
}

GET

wp-json

latepoint-api

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
  }
}

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

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

Show Booking Structure

integer

Unique booking ID

booking_code

string

Unique booking code

status

string

Current booking status

start_date

string

Start date (YYYY-MM-DD)

start_time

string

Start time (HH:MM)

end_time

string

End time (HH:MM)

duration

integer

Duration in minutes

price

string

Total booking price

customer

object

Customer information

Show Customer Data

integer

Customer ID

first_name

string

Customer first name

last_name

string

Customer last name

string

Customer email

phone

string

Customer phone

payment_status

string

Payment status of the booking

agent

object

Agent information

Show Agent Data

string

Agent ID

full_name

string

Agent full name

string

Agent email

phone

string

Agent phone

service

array

Service information (empty array if no service assigned)

location

object

Location information

Show Location Data

string

Location ID

name

string

Location name

full_address

string

Location full address

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);
}

HTTP Status Codes Create Booking

​Description

​Authentication

​Query Parameters

​Pagination

​Basic Filters

​Date Filters

​Dynamic Filters

​Metadata Filters

​Search and Sorting

​Response

​Examples

​Basic Request

​Filter by Status and Date

​Search by Customer Name or Code

​Example Response

​Error Responses

​Important Notes

​Common Use Cases

​1. Today’s Bookings Dashboard

​2. Customer History

​3. Monthly Report

Description

Authentication

Query Parameters

Pagination

Basic Filters

Date Filters

Dynamic Filters

Metadata Filters

Search and Sorting

Response

Examples

Basic Request

Filter by Status and Date

Search by Customer Name or Code

Example Response

Error Responses

Important Notes

Common Use Cases

1. Today’s Bookings Dashboard

2. Customer History

3. Monthly Report