API Reference
Services
List and retrieve services for the current business.
List Services
Returns all active services for the authenticated business.
GET /api/v1/services
Parameters
| Parameter | Type | Description |
|---|---|---|
per_page |
integer | Results per page (default: 15, max: 50) |
page |
integer | Page number |
Example Request
curl -X GET https://calendence.com/api/v1/services \
-H "Authorization: Bearer cal_ses_your_session_token"
Example Response
{
"data": [
{
"id": "01950000-de00-4000-a000-000000000030",
"name": "Express Wash",
"description": "Quick exterior wash and dry.",
"duration_min": 30,
"duration_max": 30,
"rate": 3500,
"rate_type": "flat",
"deposit_type": "none",
"deposit_amount": 0,
"is_mobile": false,
"is_active": true,
"show_staff_picker": false,
"custom_fields": []
}
],
"links": { ... },
"meta": { ... }
}
Response Fields
| Field | Type | Description |
|---|---|---|
rate |
integer | Price in cents ($35.00 = 3500) |
rate_type |
string | flat or hourly |
duration_min |
integer | Minimum duration in minutes |
duration_max |
integer | Maximum duration in minutes (same as min for fixed) |
deposit_type |
string | none, flat, or percentage |
deposit_amount |
integer | Deposit amount in cents (flat) or basis points (percentage) |
show_staff_picker |
boolean | Whether the widget shows staff selection for this service |
Show Service
GET /api/v1/services/{id}
Returns a single service by UUID.
Note: All monetary values are in integer cents. Divide by 100 for display.