Listar chamados na API v2 do SULTS

GET

api

chamados

ticket

list

Listar chamados

curl --request GET \
  --url https://api.sults.com.br/api/v2/chamados/ticket/list \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.sults.com.br/api/v2/chamados/ticket/list', 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.sults.com.br/api/v2/chamados/ticket/list",
  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: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

using RestSharp;


var options = new RestClientOptions("https://api.sults.com.br/api/v2/chamados/ticket/list");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

[
  {
    "id": 4127,
    "subject": "Forno combinado sem aquecer",
    "requesterUser": {
      "id": 63,
      "name": "Juliana Prado"
    },
    "assigneeUser": {
      "id": 55,
      "name": "Carlos Mendes"
    },
    "company": {
      "id": 12,
      "name": "Sabor Mineiro Savassi"
    },
    "inboundDepartment": {
      "id": 4,
      "name": "Manutenção"
    },
    "category": {
      "id": 23,
      "name": "Equipamento com defeito"
    },
    "collaborators": [],
    "tags": [],
    "direction": "COMPANY_TO_ADMIN",
    "openedAt": "2026-10-05T12:10:27Z",
    "originalDueDate": "2026-10-07T21:00:00Z",
    "dueDate": "2026-10-08T21:00:00Z",
    "firstResponseAt": "2026-10-05T12:48:03Z",
    "lastUpdatedAt": "2026-10-06T15:22:41Z",
    "status": "IN_PROGRESS",
    "type": "STANDARD"
  }
]

{
  "error": "Campo supplierId não pode ser vazio ou nulo."
}

{
  "error": "Acesso não autorizado."
}

{
  "error": "Campo supplierId não pode ser vazio ou nulo."
}

<string>

{
  "error": "Campo supplierId não pode ser vazio ou nulo."
}

Authorizations

Authorization

string

header

required

Token gerado na Gestão de Tokens v2 do SULTS. Deve ser enviado no cabeçalho Authorization de todas as requisições.

Query Parameters

integer

Código do chamado.

status

string

default:NEW,IN_PROGRESS,AWAITING_REQUESTER,AWAITING_ASSIGNEE

Situação do chamado. Para filtrar por mais de uma, separe os valores por vírgula (status=NEW,IN_PROGRESS). Sem o filtro, a resposta traz NEW, IN_PROGRESS, AWAITING_REQUESTER e AWAITING_ASSIGNEE.

Valor	Significado
`NEW`	Novo
`IN_PROGRESS`	Em andamento
`AWAITING_REQUESTER`	Aguardando solicitante
`AWAITING_ASSIGNEE`	Aguardando responsável
`RESOLVED`	Resolvido
`CLOSED`	Concluído

Pattern:

^(NEW|IN_PROGRESS|AWAITING_REQUESTER|AWAITING_ASSIGNEE|RESOLVED|CLOSED)(,(NEW|IN_PROGRESS|AWAITING_REQUESTER|AWAITING_ASSIGNEE|RESOLVED|CLOSED))*$

direction

enum<string>

Direção do chamado.

Valor	Significado
`ADMIN_TO_ADMIN`	Administrador para administrador
`COMPANY_TO_ADMIN`	Unidade para administrador
`ADMIN_TO_COMPANY`	Administrador para unidade

Available options:

ADMIN_TO_ADMIN,

COMPANY_TO_ADMIN,

ADMIN_TO_COMPANY

requesterUserId

integer

Código do usuário solicitante.

assigneeUserId

integer

Código do usuário responsável.

companyId

integer

Código da unidade.

categoryId

integer

Código do assunto.

openedAfter

string<date-time>

Traz os chamados abertos nesta data ou depois dela, em UTC ISO 8601.

openedBefore

string<date-time>

Traz os chamados abertos nesta data ou antes dela, em UTC ISO 8601.

resolvedAfter

string<date-time>

Traz os chamados resolvidos nesta data ou depois dela, em UTC ISO 8601.

resolvedBefore

string<date-time>

Traz os chamados resolvidos nesta data ou antes dela, em UTC ISO 8601.

closedAfter

string<date-time>

Traz os chamados concluídos nesta data ou depois dela, em UTC ISO 8601.

closedBefore

string<date-time>

Traz os chamados concluídos nesta data ou antes dela, em UTC ISO 8601.

lastUpdatedAfter

string<date-time>

Traz os chamados atualizados nesta data ou depois dela, em UTC ISO 8601.

lastUpdatedBefore

string<date-time>

Traz os chamados atualizados nesta data ou antes dela, em UTC ISO 8601.

page

integer

default:0

Número da página da listagem, começando em 0. Incremente até a resposta vir vazia.

Required range: x >= 0

Response

Lista de chamados.

integer

Código do chamado.

Example:

4127

subject

string

Título do chamado.

Example:

"Forno combinado sem aquecer"

requesterUser

object

Solicitante do chamado.

Show child attributes

assigneeUser

object

Responsável pelo atendimento do chamado.

Show child attributes

company

object

Unidade do chamado.

Show child attributes

inboundDepartment

object

Departamento de destino do chamado.

Show child attributes

tags

object[]

Etiquetas do chamado. O formato de cada item ainda não está documentado.

Example:

[]

direction

enum<string>

Direção do chamado.

Available options:

ADMIN_TO_ADMIN,

COMPANY_TO_ADMIN,

ADMIN_TO_COMPANY

Example:

"COMPANY_TO_ADMIN"

openedAt

string<date-time>

Data de abertura, em UTC ISO 8601.

Example:

"2026-10-05T12:10:27Z"

originalDueDate

string<date-time>

Prazo original do chamado, em UTC ISO 8601.

Example:

"2026-10-07T21:00:00Z"

dueDate

string<date-time>

Prazo atual do chamado, em UTC ISO 8601.

Example:

"2026-10-08T21:00:00Z"

firstResponseAt

string<date-time>

Data da primeira resposta, em UTC ISO 8601.

Example:

"2026-10-05T12:48:03Z"

lastUpdatedAt

string<date-time>

Data da última atualização, em UTC ISO 8601.

Example:

"2026-10-06T15:22:41Z"

status

enum<string>

Situação do chamado.

Available options:

NEW,

IN_PROGRESS,

AWAITING_REQUESTER,

AWAITING_ASSIGNEE,

RESOLVED,

CLOSED

Example:

"IN_PROGRESS"

type

enum<string>

Origem do chamado.

Valor	Significado
`STANDARD`	Padrão
`BROADCAST`	Chamado em massa
`MODULE_EXPANSAO_DEAL`	Criado a partir de um negócio do módulo Expansão
`MODULE_IMPLANTACAO_PROJECT`	Criado a partir de um projeto do módulo Implantação
`MODULE_IMPLANTACAO_PROJECT_TASK`	Criado a partir de uma tarefa de projeto do módulo Implantação
`MODULE_PROJETOS_PROJECT`	Criado a partir de um projeto do módulo Projetos
`MODULE_PROJETOS_PROJECT_TASK`	Criado a partir de uma tarefa de projeto do módulo Projetos
`MODULE_HELPDESK_CHAT`	Criado a partir do módulo Helpdesk

Available options:

STANDARD,

BROADCAST,

MODULE_EXPANSAO_DEAL,

MODULE_IMPLANTACAO_PROJECT,

MODULE_IMPLANTACAO_PROJECT_TASK,

MODULE_PROJETOS_PROJECT,

MODULE_PROJETOS_PROJECT_TASK,

MODULE_HELPDESK_CHAT

Example:

"STANDARD"

Listar chamados

curl --request GET \
  --url https://api.sults.com.br/api/v2/chamados/ticket/list \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.sults.com.br/api/v2/chamados/ticket/list', 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.sults.com.br/api/v2/chamados/ticket/list",
  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: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

using RestSharp;


var options = new RestClientOptions("https://api.sults.com.br/api/v2/chamados/ticket/list");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "<api-key>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

[
  {
    "id": 4127,
    "subject": "Forno combinado sem aquecer",
    "requesterUser": {
      "id": 63,
      "name": "Juliana Prado"
    },
    "assigneeUser": {
      "id": 55,
      "name": "Carlos Mendes"
    },
    "company": {
      "id": 12,
      "name": "Sabor Mineiro Savassi"
    },
    "inboundDepartment": {
      "id": 4,
      "name": "Manutenção"
    },
    "category": {
      "id": 23,
      "name": "Equipamento com defeito"
    },
    "collaborators": [],
    "tags": [],
    "direction": "COMPANY_TO_ADMIN",
    "openedAt": "2026-10-05T12:10:27Z",
    "originalDueDate": "2026-10-07T21:00:00Z",
    "dueDate": "2026-10-08T21:00:00Z",
    "firstResponseAt": "2026-10-05T12:48:03Z",
    "lastUpdatedAt": "2026-10-06T15:22:41Z",
    "status": "IN_PROGRESS",
    "type": "STANDARD"
  }
]

{
  "error": "Campo supplierId não pode ser vazio ou nulo."
}

{
  "error": "Acesso não autorizado."
}

{
  "error": "Campo supplierId não pode ser vazio ou nulo."
}

<string>

{
  "error": "Campo supplierId não pode ser vazio ou nulo."
}