GET/api/v1/categories/service/{id}

Get service category

Returns one service category by category_id for the authenticated tenant. Requires billing_settings:read permission.

RBAC · billing_settings

Path parameters

idstring <uuid>Required

Category UUID from service_categories.category_id or ticket_categories.category_id.

Response body

Success response 200

dataobjectRequired

Service category resource.

tenantstring <uuid>Required

category_idstring <uuid>Required

category_namestringRequired

descriptionstringNullable

display_orderinteger

default 0

is_activebooleanRequired

created_atstring <date-time>Required

updated_atstring <date-time>Required

created_bystring <uuid>Required

updated_bystring <uuid>Required

tagsarray of string

itemsstring

Response codes

200

Service category returned successfully.

400

Invalid category id format.

401

Authentication failed.

403

Authenticated user lacks billing settings read permission.

404

Service category not found.

GET /api/v1/categories/service/{id}

cURL

curl -X GET "https://algapsa.com/api/v1/categories/service/{id}" \
  -H "X-API-Key: $ALGA_API_KEY"

TypeScript

const response = await fetch("https://algapsa.com/api/v1/categories/service/{id}", {
  method: "GET",
  headers: {
    "X-API-Key": "$ALGA_API_KEY",
  }
});
const data = await response.json();

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://algapsa.com/api/v1/categories/service/{id}");
request.Headers.TryAddWithoutValidation("X-API-Key", "$ALGA_API_KEY");
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

200 OK·application/json

{
  "data": {
    "tenant": "01HN2K7VRB9PQ3Y0000000000",
    "category_id": "01HN2K7VRB9PQ3Y0000000000",
    "category_name": "string",
    "description": "string",
    "display_order": 0,
    "is_active": false,
    "created_at": "2026-04-18T15:22:14Z",
    "updated_at": "2026-04-18T15:22:14Z",
    "created_by": "01HN2K7VRB9PQ3Y0000000000",
    "updated_by": "01HN2K7VRB9PQ3Y0000000000",
    "tags": [
      "string"
    ]
  }
}