List all tickets

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

Returns a paginated list of support tickets with filtering options including ticket status (open/closed), domain, assigned teammate, customer, text search, and date ranges.

Query Parameters

page integer*

per_page integer*

order string

ascdesc

sort_by string

created_attitle

closed boolean

Filter by status — true for closed tickets, false for open tickets, omit for all

domain_id string

Filter tickets by domain UUID

teammate_id string

Filter tickets assigned to a specific teammate UUID

customer_id string

Filter tickets created by a specific customer UUID

filter string

Text search against ticket titles, descriptions, or conversation content

from string

Start date filter (ISO format or Unix timestamp)

to string

End date filter (ISO format or Unix timestamp)

Responses

200 Tickets retrieved successfully

Tickets retrieved successfully

status integer

total_results integer

Total number of tickets matching the query

tickets array of Ticket

id string

Unique ticket identifier

object string

title string

Ticket title/subject

is_open boolean

Whether the ticket is open (true) or closed (false)

created_at integer

Unix timestamp of creation

updated_at integer

Unix timestamp of last update

customer object

Customer who created the ticket (empty object if customer was deleted)

id string

name string

email string

teammate_id string

UUID of the assigned teammate, or null if unassigned

replies array of TicketReply

Conversation history ordered chronologically

id string

Unique reply identifier

text string

Reply message content

is_customer_reply boolean

Whether this reply is from the customer (true) or merchant (false)

translations object

Map of language codes to translated reply content

created_at integer

Unix timestamp of when the reply was created

domain_id string

UUID of the domain where the ticket was submitted

domain string

Domain name

language string

Ticket language code

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`1002`	Referenced domain, teammate, or customer not found

status integer

error string

Human-readable error message

error_code integer

Machine-readable error code

401 Missing or invalid API key

Retrieve a ticket

/tickets/list

1 const response = await fetch("https://api.tamio.com/v2/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/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": 24,
  "tickets": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "object": "ticket",
      "title": "Payment not processing",
      "is_open": true,
      "created_at": 1699123456,
      "updated_at": 1699123789,
      "customer": {
        "id": "00000000-0000-0000-0000-000000000000",
        "name": "John Doe",
        "email": "[email protected]"
      },
      "teammate_id": "00000000-0000-0000-0000-000000000000",
      "replies": [
        {
          "id": "00000000-0000-0000-0000-000000000000",
          "text": "string",
          "is_customer_reply": false,
          "translations": {},
          "created_at": 0
        }
      ],
      "domain_id": "00000000-0000-0000-0000-000000000000",
      "domain": "shop.example.com",
      "language": "en"
    }
  ]
}

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