---
title: "Listar PIX"
method: GET
path: "/pix/list"
---

# Listar PIX

`GET /pix/list`

Consulta um envio de PIX pelo `id`. Apesar do nome, esta rota não pagina nem aceita filtros: `id` é obrigatório e o contrato é o mesmo de `/pix/get`.

## Query parameters

- `id` string, required
- `externalId` string

## Response `200`

Lista de PIX retornada com sucesso.

- object
  - `data` PixTransaction[] — Lista de transações PIX criadas.
    - `id` string, required — Identificador único da transação PIX.
    - `status` 'PENDING' | 'EXPIRED' | 'CANCELLED' | 'COMPLETE' | 'REFUNDED', required — Status atual da transação.
    - `devMode` boolean, required — Indica se a transação foi criada em ambiente de testes.
    - `receiptUrl` string, uri, required — URL do comprovante da transação.
    - `amount` number, required — Valor da transação em centavos.
    - `platformFee` number, required — Taxa da plataforma em centavos.
    - `externalId` string, nullable — Identificador externo da transação.
    - `createdAt` string, date-time, required — Data de criação da transação.
    - `updatedAt` string, date-time, required — Data de atualização da transação.
  - `success` boolean — Se a requisição obteve sucesso ou não.
  - `error` string, nullable
  - `pagination` PaginationCursor — Informações de paginação baseada em cursor.
    - `hasMore` boolean, required — Indica se existe mais itens para carregar.
    - `next` string, nullable, required — Cursor para próxima página (usar em after).
    - `before` string, nullable, required — Cursor para página anterior (usar em before).

## Other responses

- `401` — Não autorizado. Falha na autenticação.

## Changes

> 5 revisions in range; 2 could not be searched.

- **2026-08-04** `6b89a7fa70f5` — 2 info
  - added the new optional `query` request parameter `endDate`
  - added the new optional `query` request parameter `startDate`

[Change history](https://skmtc.dev/abacatepay/apis/api-abacatepay/changes/pix/list/get.md)

---

[API](https://skmtc.dev/abacatepay/apis/api-abacatepay.md) · [All operations](https://skmtc.dev/abacatepay/apis/api-abacatepay/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/abacatepay/api-abacatepay/revisions/ea8a72b04f2a/schema)