Welcome to LatePoint API

LatePoint API Extension provides a complete REST interface to interact with your LatePoint booking system. This API allows you to integrate LatePoint with external applications, create custom automations, and build unique user experiences.

Key Features

RESTful Design

API designed following REST principles with intuitive endpoints and standard HTTP methods

Secure Authentication

API Key system with granular permissions and configurable rate limiting

JSON Responses

All responses in JSON format with consistent structure and HTTP status codes

Complete Documentation

Code examples in multiple languages and detailed use cases

Base URL

All API requests use the following base URL:
https://your-site.com/wp-json/latepoint-api/v1

Authentication

Each request must include your API Key in the header:
X-API-Key: your_api_key_here
Learn more about authentication →

Response Structure

Successful Responses

All successful responses follow this structure:
{
  "status": "success",
  "data": {
    // Requested data
  },
  "meta": {
    "total": 100,
    "page": 1,
    "per_page": 20,
    "total_pages": 5
  }
}

Error Responses

Errors follow this structure:
{
  "status": "error",
  "error": {
    "code": "invalid_request",
    "message": "Error description",
    "details": {
      "field": "Additional information"
    }
  }
}

HTTP Status Codes

CodeMeaningDescription
200OKSuccessful request
201CreatedResource created successfully
400Bad RequestMalformed request
401UnauthorizedMissing or invalid API Key
403ForbiddenInsufficient permissions
404Not FoundResource not found
422Unprocessable EntityInvalid input data
429Too Many RequestsRate limit exceeded
500Internal Server ErrorServer error

Pagination

Pagination Parameters

Endpoints that return lists support pagination:
GET /bookings?page=2&per_page=50
Parameters:
  • page: Page number (default: 1)
  • per_page: Items per page (default: 20, maximum: 100)

Paginated Response

{
  "status": "success",
  "data": [...],
  "meta": {
    "total": 150,
    "page": 2,
    "per_page": 50,
    "total_pages": 3,
    "has_next_page": true,
    "has_prev_page": true
  }
}

Common Filters

Most endpoints support filters:
GET /bookings?status=confirmed&date_from=2024-01-01&date_to=2024-01-31
For free text searches:
GET /customers?search=john+doe

Sorting

Specify the order of results:
GET /bookings?sort=start_date&order=desc
Parameters:
  • sort: Field to sort by
  • order: asc (ascending) or desc (descending)

Rate Limiting

Default Limits

API Key TypePer MinutePer Hour
Test1001,000
Live603,600

Rate Limiting Headers

Each response includes information about your current usage:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1640995200
Learn more about rate limiting →

Available Resources

Bookings

Complete booking management:
  • GET /bookings - List bookings
  • POST /bookings - Create booking
  • GET /bookings/{id} - Get booking
  • PUT /bookings/{id} - Update booking
  • DELETE /bookings/{id} - Delete booking
View complete documentation →

Customers

Customer administration:
  • GET /customers - List customers
  • POST /customers - Create customer
  • GET /customers/{id} - Get customer
  • PUT /customers/{id} - Update customer
View complete documentation →

Agents

Agent and schedule queries:
  • GET /agents - List agents
  • GET /agents/{id} - Get agent
View complete documentation →

Services

Available services queries:
  • GET /services - List services
  • GET /services/{id} - Get service
View complete documentation →

Availability

Availability verification:
  • GET /availability - Check availability
View complete documentation →

Date and Time Formats

ISO 8601 Format

All dates and times use ISO 8601 format:
{
  "start_date": "2024-01-15",
  "start_time": "14:30",
  "created_at": "2024-01-15T14:30:00Z"
}

Timezone

Dates are handled in the timezone configured in WordPress. To get the current timezone:
GET /status
{
  "status": "success",
  "data": {
    "timezone": "America/New_York",
    "current_time": "2024-01-15T14:30:00-05:00"
  }
}

Versioning

Current Version

The current API version is v1. All URLs include the version:
/wp-json/latepoint-api/v1/

Compatibility

We are committed to maintaining backward compatibility within the same major version. Breaking changes will be introduced in new versions.

Usage Examples

Basic Example

curl -X GET "https://your-site.com/wp-json/latepoint-api/v1/services" \
  -H "X-API-Key: lp_live_1234567890abcdef" \
  -H "Content-Type: application/json"

Next Steps

Support

If you need help:
  1. Documentation: Review the specific documentation for each endpoint
  2. Examples: Check the code examples in each section
  3. Technical support: Contact through your LatePoint account
  4. Community: Participate in LatePoint forums