Listar Terminais

Retorna a lista de terminais associados à sua conta, com suporte a paginação por cursor e ordenação.

Endpoint

GET/v1/terminals

Parâmetros de Query

Parâmetro	Tipo	Obrigatório	Descrição
cursor	string	—	Token de paginação retornado pela resposta anterior. Omitir na primeira página.
limit	integer	—	Itens por página (padrão: 20, máximo: 100)
order_by	string	—	Campo utilizado para ordenação (ex.: created_at)
sort	string	—	Direção da ordenação: ASC ou DESC

Response

{
  "metadata": {
    "nextCursor": "d59gpddc93gc73jvje1h",
    "previousCursor": null,
    "limit": 20
  },
  "data": [
    {
      "id": "d59gpddc93gc73jvje0g",
      "serialNumber": "SN123456",
      "active": true,
      "merchantId": "d6uo5nc42nrc73gv867g",
      "createdAt": "2026-05-06T10:00:00Z",
      "updatedAt": "2026-05-06T10:00:00Z"
    }
  ]
}

Campos da Resposta

Resposta paginada — envelope padrão da plataforma (ver Filtros e Paginação):

Campo	Tipo	Descrição
metadata.nextCursor	string | null	Token para a próxima página. null na última página.
metadata.previousCursor	string | null	Token para a página anterior. null na primeira página.
metadata.limit	integer	Quantidade de itens retornados na página
data	array	Lista de terminais — cada item tem os campos abaixo

Terminal

Campo	Tipo	Descrição
id	string	ID único do terminal
serialNumber	string	Número de série do terminal
active	boolean	Indica se o terminal está ativo
merchantId	string	ID do lojista associado
createdAt	string	Data de criação (ISO 8601)
updatedAt	string	Data da última atualização (ISO 8601)

Retorna HTTP 204 se não houver resultados.