Skip to content

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.