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

Resposta

Campo	Tipo	Descrição
metadata.cursor	string | null	Token para a próxima página. null indica última página.
metadata.limit	integer	Quantidade de itens retornados
data	array	Lista de terminais

Retorna HTTP 204 se não houver resultados.

Request

curl https://yby-dev.positivolabs.com.br/v1/terminals \
  -H "Authorization: Bearer <access_token>" \
  -G \
  --data-urlencode "limit=20" \
  --data-urlencode "order_by=created_at" \
  --data-urlencode "sort=DESC"

Resposta

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