List services (defaults + company)

GET

/api/v1/services

Last modified:2026-03-01 17:13:11

Returns merged services: JSON defaults plus company-saved services. Supports filtering by audience + search.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://connect.dispatchable.com/catalog/api/v1/services?search=install&audience=hvac&per_page=50&is_active=1' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Response Example

200 - merged

{
    "data": [
        {
            "uuid": null,
            "source": "default_json",
            "key": "free_assessment",
            "name": "Free Assessment",
            "description": "Our experts will come to assess your needs and discuss solutions",
            "category": "General",
            "audiences": [
                "hvac",
                "home_services",
                "shipper"
            ],
            "default_quantity": 1,
            "default_unit_cost": 0,
            "default_unit_price": 0,
            "unit_label": "visit",
            "sort_order": 10,
            "is_active": true,
            "is_system": true
        },
        {
            "uuid": "2e7b6d14-4c5c-46d2-a0bd-0cbf0e79a1a2",
            "source": "company_db",
            "key": null,
            "name": "Ductwork Repair",
            "description": "Repair and reseal ductwork",
            "category": "Labor",
            "audiences": [
                "hvac"
            ],
            "default_quantity": 1,
            "default_unit_cost": 65,
            "default_unit_price": 120,
            "unit_label": "hour",
            "sort_order": 50,
            "is_active": true,
            "is_system": false
        }
    ],
    "meta": {
        "count": 2
    }
}

Modified at 2026-03-01 17:13:11

Update Status

Create a company default service