GET/api/v1/categories/ticket

List ticket categories

Returns paginated ticket categories. Requires ticket_settings:read permission.

RBAC · ticket_settings

Query parameters

pagestringOptional

limitstringOptional

sortstringOptional

orderstringOptional

searchstringOptional

created_fromstring <date-time>Optional

created_tostring <date-time>Optional

updated_fromstring <date-time>Optional

updated_tostring <date-time>Optional

category_namestringOptional

board_idstring <uuid>Optional

parent_categorystring <uuid>Optional

is_parentstringOptional

is_childstringOptional

depthstringOptional

activestringOptional

offsetstringOptional

sort_bystringOptional

sort_orderstringOptional

include_hierarchystringOptional

category_typestringOptional

Response body

Success response 200 · schema PaginatedTicketCategoryResponse

dataarray of TicketCategoryRequired

itemsobject

Ticket category resource from ticket_categories, including optional hierarchy fields.

category_idstring <uuid>Required

category_namestringRequired

parent_categorystring <uuid>Nullable

board_idstring <uuid>Required

descriptionstringNullable

created_bystring <uuid>Required

updated_bystring <uuid>Required

created_atstring <date-time>

updated_atstring <date-time>

tenantstring <uuid>Required

childrenarray of any

itemsany

depthnumber

pathstring

children_countnumber

paginationobjectRequired

pageintegerRequired

limitintegerRequired

totalintegerRequired

totalPagesintegerRequired

hasNextbooleanRequired

hasPrevbooleanRequired

metaobject

Response codes

200

Ticket categories returned successfully.

400

Invalid query parameters.

401

Authentication failed.

403

Authenticated user lacks ticket settings read permission.

GET /api/v1/categories/ticket

cURL

curl -X GET "https://algapsa.com/api/v1/categories/ticket?page=string&limit=string&sort=string&order=asc&search=string&created_from=2026-04-18T15%3A22%3A14Z" \
  -H "X-API-Key: $ALGA_API_KEY"

TypeScript

const response = await fetch("https://algapsa.com/api/v1/categories/ticket?page=string&limit=string&sort=string&order=asc&search=string&created_from=2026-04-18T15%3A22%3A14Z", {
  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/ticket?page=string&limit=string&sort=string&order=asc&search=string&created_from=2026-04-18T15%3A22%3A14Z");
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": [
    {
      "category_id": "01HN2K7VRB9PQ3Y0000000000",
      "category_name": "string",
      "parent_category": "01HN2K7VRB9PQ3Y0000000000",
      "board_id": "01HN2K7VRB9PQ3Y0000000000",
      "description": "string",
      "created_by": "01HN2K7VRB9PQ3Y0000000000",
      "updated_by": "01HN2K7VRB9PQ3Y0000000000",
      "created_at": "2026-04-18T15:22:14Z",
      "updated_at": "2026-04-18T15:22:14Z",
      "tenant": "01HN2K7VRB9PQ3Y0000000000",
      "children": [
        null
      ],
      "depth": 0,
      "path": "string",
      "children_count": 0
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1,
    "hasNext": false,
    "hasPrev": false
  },
  "meta": {}
}