Agency API Agency

List all tickets

GET https://api.tamio.com/v2/agency/tickets/list

Returns a paginated list of support tickets. Supports filtering by status, date range, text search, teammate, and client.

Query Parameters

page integer*

Page number for pagination

per_page integer*

Number of results per page

order string

ascdesc

sort_by string

created_attitle

filter string

Search tickets by title

from string

Start date filter (ISO 8601 or unix timestamp)

to string

End date filter (ISO 8601 or unix timestamp)

closed string

Filter by closed status

truefalse

teammate_id string

Filter by assigned teammate UUID

client_id string

Filter by client UUID

Responses

200 Tickets listed successfully

Tickets listed successfully

status integer

total_results integer

tickets array of Ticket

id string

object string

title string

is_open boolean

category string

Title of the ticket category

subcategory string

teammate_id string

UUID of the assigned teammate

client object

Client who created the ticket

id string

name string

email string

language string

created_at integer

Unix timestamp

updated_at integer

Unix timestamp

replies array of object

id string

text string

is_client_reply boolean

created_at integer

Unix timestamp

assets array of object

File attachments on this reply, serialized via the asset object service

id string

Unique identifier of the asset

object string

Object type identifier

filename string

Original filename of the uploaded file

extension string

File extension

filesize integer

File size in bytes

type string

Asset type (e.g. image, document, video)

version integer

Asset version number

status string

Processing status of the asset

alt_text string

Alt text for accessibility

width integer

Image width in pixels (null for non-image assets)

height integer

Image height in pixels (null for non-image assets)

public_url string

Public CDN URL for the asset

folder string

UUID of the parent folder

thumbnails array of object

Thumbnail variants for image assets

url string

CDN URL of the thumbnail

width integer

Thumbnail width in pixels

height integer

Thumbnail height in pixels

created_at integer

Unix timestamp when the asset was uploaded

updated_at integer

Unix timestamp when the asset was last modified

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`10147`	Agency domain not validated
`1002`	Teammate or client not found

status integer

error string

error_code integer

401 Unauthorized – invalid or missing Bearer token

Delete a billing plan

Create a ticket

/agency/tickets/list

1 const response = await fetch("https://api.tamio.com/v2/agency/tickets/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/tickets/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": 42,
  "tickets": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "object": "ticket",
      "title": "Payment processing issue",
      "is_open": true,
      "category": "Billing Issues",
      "subcategory": "Payment Failed",
      "teammate_id": "770e8400-e29b-41d4-a716-446655440000",
      "client": {
        "id": "660e8400-e29b-41d4-a716-446655440000",
        "name": "John Doe",
        "email": "[email protected]"
      },
      "language": "en",
      "created_at": 1700000000,
      "updated_at": 1700086400,
      "replies": [
        {
          "id": "880e8400-e29b-41d4-a716-446655440000",
          "text": "We have resolved your issue.",
          "is_client_reply": false,
          "created_at": 1700000000,
          "assets": [
            {
              "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
              "object": "asset",
              "filename": "screenshot.png",
              "extension": "png",
              "filesize": 204800,
              "type": "image",
              "version": 1,
              "status": "ready",
              "alt_text": "Error screenshot",
              "width": 1920,
              "height": 1080,
              "public_url": "https://pub.ox31.com/assets/screenshot.png",
              "folder": null,
              "thumbnails": [],
              "created_at": 1700000000,
              "updated_at": 1700086400
            }
          ]
        }
      ]
    }
  ]
}

1	const response = await fetch("https://api.tamio.com/v2/agency/tickets/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/tickets/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