List tickets
Lists the company’s tickets, ordered by last update. Through the API there is no per-agent visibility filter like the one the system screen applies. The token sees all of the company’s tickets.
Each ticket includes the Meta window (metaWindowOpenTimestamp, metaWindowType) and the
current protocol (protocol), loaded per page, with no extra call.
curl --request GET \
--url https://api.connectadesk.com/api/v1/tickets \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.connectadesk.com/api/v1/tickets"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.connectadesk.com/api/v1/tickets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.connectadesk.com/api/v1/tickets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.connectadesk.com/api/v1/tickets"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.connectadesk.com/api/v1/tickets")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.connectadesk.com/api/v1/tickets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 5120,
"status": "open",
"unreadMessages": 2,
"lastMessage": "Perfeito, vou querer o tamanho M",
"isGroup": false,
"automation": false,
"contact": {
"id": 842,
"name": "Maria Silva",
"number": "5511987654321",
"numberCountry": "BR",
"email": "maria.silva@exemplo.com.br",
"code": "CLI-00842",
"cpfCnpj": "12345678909",
"origin": "site",
"profilePicUrl": "https://cdn.exemplo.com/avatars/842.jpg",
"isGroup": false,
"instagramUsername": "maria.silva",
"lid": null,
"sourceUrl": "https://loja.exemplo.com.br/promo",
"sourceId": "23851234567890123",
"headline": "Coleção de inverno",
"mediaType": "image",
"mediaUrl": "https://cdn.exemplo.com/anuncios/inverno.jpg",
"utmSource": "instagram",
"utmMedium": "cpc",
"utmCampaign": "inverno-2026",
"utmId": "6543210987",
"fbclid": "IwAR0xYzAbC123",
"gclid": null,
"ctwaClid": null,
"tags": [
{
"id": 3,
"name": "Cliente VIP",
"color": "#6941C6"
}
],
"customFields": [
{
"key": "plano",
"value": "Ouro",
"customFieldId": 91,
"name": "Plano",
"type": "select"
}
],
"lastChannel": {
"id": 11,
"name": "Instagram Loja",
"type": "instagram"
},
"createdAt": "2026-07-14T13:22:05.412Z",
"updatedAt": "2026-08-18T09:41:17.883Z"
},
"queue": {
"id": 13,
"name": "Comercial",
"color": "#0E7490"
},
"user": {
"id": 3,
"name": "Gabriel Goulart"
},
"channel": {
"id": 11,
"name": "Instagram Loja",
"type": "instagram"
},
"tags": [
{
"id": 3,
"name": "Cliente VIP",
"color": "#6941C6"
}
],
"metaWindowOpenTimestamp": "2026-08-18T14:20:03.000Z",
"metaWindowType": 24,
"protocol": {
"id": 21877,
"userId": 3,
"channelId": 11,
"startedFrom": "receptive",
"startedFromContact": true,
"fromApi": false,
"fromAutomation": false,
"campaignSlug": null,
"rated": false,
"nps": null,
"createdAt": "2026-08-18T12:03:44.001Z",
"queuedAt": "2026-08-18T12:03:44.120Z",
"startedAt": "2026-08-18T12:05:10.300Z",
"userFirstAnswerAt": "2026-08-18T12:05:41.002Z",
"lastCustomerReplyAt": "2026-08-18T14:20:03.000Z",
"lastOperatorReplyAt": "2026-08-18T14:27:10.556Z",
"finishedAt": null,
"ratingAt": null,
"metaData": {
"pedido": "PED-48213",
"origem": "site"
}
},
"createdAt": "2026-08-18T12:03:44.001Z",
"updatedAt": "2026-08-18T14:27:10.556Z"
}
],
"meta": {
"page": 1,
"perPage": 20,
"hasMore": true
}
}Authorizations
API token in the sk_live_… format.
Query Parameters
Page number, starting at 1. An invalid value is treated as 1.
x >= 1Number of items per page. The maximum depends on the environment (default 100).
1 <= x <= 100Filters by ticket status. Accepts several values separated by commas (e.g. open,pending).
"open,pending"
Only tickets in this queue.
Only tickets assigned to this agent.
Only tickets with this tag.
Start of the period, in the company's time zone.
End of the period, in the company's time zone.
Sets which date the period filter uses: the creation date or the last update date.
created, updated curl --request GET \
--url https://api.connectadesk.com/api/v1/tickets \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.connectadesk.com/api/v1/tickets"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.connectadesk.com/api/v1/tickets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.connectadesk.com/api/v1/tickets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.connectadesk.com/api/v1/tickets"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.connectadesk.com/api/v1/tickets")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.connectadesk.com/api/v1/tickets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": 5120,
"status": "open",
"unreadMessages": 2,
"lastMessage": "Perfeito, vou querer o tamanho M",
"isGroup": false,
"automation": false,
"contact": {
"id": 842,
"name": "Maria Silva",
"number": "5511987654321",
"numberCountry": "BR",
"email": "maria.silva@exemplo.com.br",
"code": "CLI-00842",
"cpfCnpj": "12345678909",
"origin": "site",
"profilePicUrl": "https://cdn.exemplo.com/avatars/842.jpg",
"isGroup": false,
"instagramUsername": "maria.silva",
"lid": null,
"sourceUrl": "https://loja.exemplo.com.br/promo",
"sourceId": "23851234567890123",
"headline": "Coleção de inverno",
"mediaType": "image",
"mediaUrl": "https://cdn.exemplo.com/anuncios/inverno.jpg",
"utmSource": "instagram",
"utmMedium": "cpc",
"utmCampaign": "inverno-2026",
"utmId": "6543210987",
"fbclid": "IwAR0xYzAbC123",
"gclid": null,
"ctwaClid": null,
"tags": [
{
"id": 3,
"name": "Cliente VIP",
"color": "#6941C6"
}
],
"customFields": [
{
"key": "plano",
"value": "Ouro",
"customFieldId": 91,
"name": "Plano",
"type": "select"
}
],
"lastChannel": {
"id": 11,
"name": "Instagram Loja",
"type": "instagram"
},
"createdAt": "2026-07-14T13:22:05.412Z",
"updatedAt": "2026-08-18T09:41:17.883Z"
},
"queue": {
"id": 13,
"name": "Comercial",
"color": "#0E7490"
},
"user": {
"id": 3,
"name": "Gabriel Goulart"
},
"channel": {
"id": 11,
"name": "Instagram Loja",
"type": "instagram"
},
"tags": [
{
"id": 3,
"name": "Cliente VIP",
"color": "#6941C6"
}
],
"metaWindowOpenTimestamp": "2026-08-18T14:20:03.000Z",
"metaWindowType": 24,
"protocol": {
"id": 21877,
"userId": 3,
"channelId": 11,
"startedFrom": "receptive",
"startedFromContact": true,
"fromApi": false,
"fromAutomation": false,
"campaignSlug": null,
"rated": false,
"nps": null,
"createdAt": "2026-08-18T12:03:44.001Z",
"queuedAt": "2026-08-18T12:03:44.120Z",
"startedAt": "2026-08-18T12:05:10.300Z",
"userFirstAnswerAt": "2026-08-18T12:05:41.002Z",
"lastCustomerReplyAt": "2026-08-18T14:20:03.000Z",
"lastOperatorReplyAt": "2026-08-18T14:27:10.556Z",
"finishedAt": null,
"ratingAt": null,
"metaData": {
"pedido": "PED-48213",
"origem": "site"
}
},
"createdAt": "2026-08-18T12:03:44.001Z",
"updatedAt": "2026-08-18T14:27:10.556Z"
}
],
"meta": {
"page": 1,
"perPage": 20,
"hasMore": true
}
}
