Overview
The PMOS API provides programmatic access to your pool management data. All API requests are made over HTTPS to https://api.pmos.asia/v1/.
Responses are returned in JSON format. The API follows RESTful conventions with standard HTTP methods and status codes.
Authentication
Authenticate using Bearer tokens. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Generate API keys in your PMOS dashboard under Settings → API Keys.
Jobs
GET/v1/jobs — List all jobs
GET/v1/jobs/:id — Get job details
POST/v1/jobs — Create a new job
PUT/v1/jobs/:id — Update a job
DELETE/v1/jobs/:id — Cancel a job
Technicians
GET/v1/technicians — List all technicians
GET/v1/technicians/:id — Get technician details
GET/v1/technicians/:id/location — Get live location
Properties
GET/v1/properties — List all properties
POST/v1/properties — Add a new property
GET/v1/properties/:id/pools — List pools for a property
Water Tests
GET/v1/water-tests — List all test results
POST/v1/water-tests — Submit test result
GET/v1/water-tests/:id/certificate — Download certificate
Invoices
GET/v1/invoices — List all invoices
POST/v1/invoices — Create an invoice
POST/v1/invoices/:id/send — Send invoice to client
Webhooks
Subscribe to real-time events by registering webhook endpoints:
POST/v1/webhooks — Register a webhook
Available events: job.created, job.completed, water_test.submitted, invoice.paid, technician.location_update