Skip to main content

Overview

Returns the full details of a single service by its ID. Only services enabled for your partner account are accessible.

Endpoint

GET /partners/services/:serviceId

Authentication

Requires a valid API Key with the partner_services_read permission.

Path Parameters

ParameterTypeRequiredDescription
serviceIdUUIDYesThe service ID from the catalog.

Example Request

curl -X GET "https://apiv3.thecleanlife.dev/v1/partners/services/dddddddd-0000-0000-0000-000000000004" \
  -H "x-api-key: YOUR_API_KEY"

Success Response

HTTP Status: 200 OK
{
  "success": true,
  "data": {
    "id": "dddddddd-0000-0000-0000-000000000004",
    "name": "Regular Cleaning",
    "isActive": true
  }
}

Error Responses

HTTP StatusCodeDescription
400VALIDATION_ERRORserviceId is not a valid UUID
401UNAUTHORIZEDMissing or invalid API key
403FORBIDDENMissing partner_services_read permission
404RESOURCE_NOT_FOUNDService not found or not enabled for your partner account

  • GET /partners/services — List all services
  • GET /partners/timeslots/available — Get available timeslots for this service
  • POST /partners/pricing/calculate-price — Calculate price for this service