Scope: sales:services.read https://api.alladdin.com/api/v2/services/{serviceId}

Retrieves the full details of a single service by its unique identifier.
The response includes pricing, tax configuration, sales channel assignment, and duration.

Parameters

Path parameters

serviceId string required

Service ID (24-char hex ObjectId)

Request

import requests

url = "https://api.alladdin.com/api/v2/services/{serviceId}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Responses

Response

{
  "id": "507f1f77bcf86cd799439011",
  "name": "Consulting",
  "code": "SRV-001",
  "description": "Consulting service",
  "price": "100.00",
  "cost": "50.00",
  "tags": [
    "string"
  ],
  "taxes": [
    "string"
  ],
  "sales_channel_id": "string",
  "color": "string",
  "duration": "string",
  "archived": false
}

Success responses

200 Service found application/json object id string

Unique identifier of the service

name string

Name of the service

code string

Internal reference code for the service

description string

Description of the service

price string

Sale price as a decimal string

cost string

Cost price as a decimal string

tags[] string[]

List of tags attached to the service

taxes[] string[]

List of tax identifiers applied to the service

sales_channel_id string | null

Identifier of the sales channel assigned to this service

color string | null

Hex color code used in the UI

duration string | null

Duration in minutes as a decimal string

archived boolean

Whether the service is archived

Error responses

401 Invalid or missing API key application/json 403 Insufficient permissions application/json 404 Service not found application/json 429 Rate limit exceeded application/json

← PreviousList services →

Next →Delete a service →