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 languagecurl -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/bookingsRetrieve a paginated list of all appointments. Results are sorted with the most recent appointments first.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default: 1). |
| limit | integer | Records per page (Max 100). |
| status | string | Filter by lifecycle status. |
| serviceId | string | Filter appointments by specific service UUID. |
POST
/api/v1/bookingsProgrammatically 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/servicesRetrieve all active service offerings configured in your business catalog.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number. |
| limit | integer | Items per page (Max 100). |
| active | boolean | Filter by active status. |
GET
/api/v1/customersRetrieve a paginated list of all customer profiles in your system.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number. |
| limit | integer | Items per page (Max 100). |
| search | string | Search by client name or email address. |