Agency API Agency

List all ticket categories

GET https://api.tamio.com/v2/agency/ticket-categories/list

Returns a paginated list of ticket categories. Supports filtering by date range and sorting.

Query Parameters

page integer*

Page number for pagination

per_page integer*

Number of results per page

order string

ascdesc

sort_by string

created_attitle

from string

Start date filter (ISO 8601 or unix timestamp)

to string

End date filter (ISO 8601 or unix timestamp)

Responses

200 Ticket categories listed successfully

Ticket categories listed successfully

status integer

total_results integer

ticket_categories array of TicketCategory

id string

object string

title string

language string

teammate_id string

UUID of the auto-assigned teammate

auto_reply string

subcategories array of string

billing_plans array of string

created_at integer

Unix timestamp

400 Validation or business-logic error.

Code	Description
`400`	Schema validation failed

401 Unauthorized – invalid or missing Bearer token

Delete a ticket

Create a ticket category

/agency/ticket-categories/list

1 const response = await fetch("https://api.tamio.com/v2/agency/ticket-categories/list", {
2   headers: {
3     "Authorization": "Bearer YOUR_API_KEY",
4     "Accept": "application/json"
5   }
6 });
7 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/agency/ticket-categories/list")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Get.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 
13 response = https.request(request)
14 puts response.read_body

Responses

{
  "status": 200,
  "total_results": 5,
  "ticket_categories": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "object": "ticket_category",
      "title": "Billing Issues",
      "language": "en",
      "teammate_id": "770e8400-e29b-41d4-a716-446655440000",
      "auto_reply": "Thank you for contacting us.",
      "subcategories": [
        "Payment Failed",
        "Refund Request"
      ],
      "billing_plans": [
        "550e8400-e29b-41d4-a716-446655440001",
        "550e8400-e29b-41d4-a716-446655440002"
      ],
      "created_at": 1700000000
    }
  ]
}

1	const response = await fetch("https://api.tamio.com/v2/agency/ticket-categories/list", {
2	headers: {
3	"Authorization": "Bearer YOUR_API_KEY",
4	"Accept": "application/json"
5	}
6	});
7	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/agency/ticket-categories/list")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Get.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12
13	response = https.request(request)
14	puts response.read_body