Skip to main content
PynathPynath
OpenAPI 3.1.0• v1.0 Production

REST API Reference

Base URL: https://booking.pynath.com/api/v1

Interactive Code Playground

Select an endpoint and language
curl -X GET "https://booking.pynath.com/api/v1/bookings?limit=10&status=CONFIRMED" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json"

Available Endpoints

GET/api/v1/bookings

Retrieve a paginated list of all appointments. Results are sorted with the most recent appointments first.

Query Parameters
ParameterTypeDescription
pageintegerPage number (default: 1).
limitintegerRecords per page (Max 100).
statusstringFilter by lifecycle status.
serviceIdstringFilter appointments by specific service UUID.
POST/api/v1/bookings

Programmatically create a new appointment for an active service. Checks provider availability and synchronizes online slot calendars.

Request Body (application/json)

Required: serviceId, customerName, customerEmail, startTime, endTime

{
  "serviceId": "srv_haircut_luxe",
  "customerName": "Elena Rostova",
  "customerEmail": "[email protected]",
  "customerPhone": "+91 98765 43210",
  "startTime": "2026-08-10T14:00:00Z",
  "endTime": "2026-08-10T14:45:00Z",
  "notes": "Prefers window styling chair"
}
GET/api/v1/services

Retrieve all active service offerings configured in your business catalog.

Query Parameters
ParameterTypeDescription
pageintegerPage number.
limitintegerItems per page (Max 100).
activebooleanFilter by active status.
GET/api/v1/customers

Retrieve a paginated list of all customer profiles in your system.

Query Parameters
ParameterTypeDescription
pageintegerPage number.
limitintegerItems per page (Max 100).
searchstringSearch by client name or email address.