Skip to main content
curl --request GET \
  --url 'https://api.pagou.ai/pix/v1/transactions?period=15&page=1&limit=10&order=DESC' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'apiKey: <sua-api-key>'

{
  "items": [
    {
      "id": "cb3e7f07-e7fd-4785-92c2-1abc281cd46e",
      "value": 0.5,
      "fee": 0.01,
      "netValue": 0.49,
      "operationStatus": "ERROR",
      "endToEnd": null,
      "externalId": null,
      "paymentSettlementDate": null,
      "createdAt": "2025-06-06T14:12:50.598Z",
      "updatedAt": "2025-06-06T14:18:51.882Z"
    },
    {
      "id": "1b501dd6-9182-49a6-8080-a9d2112b5c7c",
      "value": 0.1,
      "fee": 0.01,
      "netValue": 0.09,
      "operationStatus": "WAITING_CONFIRMATION",
      "endToEnd": null,
      "externalId": null,
      "paymentSettlementDate": null,
      "createdAt": "2025-06-06T14:39:24.001Z",
      "updatedAt": "2025-06-06T14:39:24.001Z"
    }
    // ... mais itens ...
  ],
  "total": 15,
  "totalPages": 3
}
Recupere uma lista paginada de transações Pix da sua conta. Use parâmetros de consulta para filtrar por período, página, limite e ordem.
Este endpoint permite buscar o histórico de transações para conciliação, relatórios ou auditoria.

​
Endpoint de Produção

GET https://api.pagou.ai/pix/v1/transactions
1

Defina os cabeçalhos obrigatórios

Inclua os seguintes cabeçalhos na sua requisição:
​
Content-Type
string
required
Sempre defina como application/json.
​
apiKey
string
required
Sua chave de API. Exemplo: sk_live_1234
2

Configure os parâmetros de consulta

Adicione parâmetros de consulta para filtrar e paginar os resultados:
​
period
number
required
Número de dias retroativos a partir da data atual. O padrão é 15. O máximo é 90.
​
page
number
Número da página para paginação.
​
limit
number
Quantidade de transações por página. O padrão é 15. O máximo é 90.
​
order
string
Ordem de classificação pela data de criação. Valores permitidos:
  • ASC (crescente)
  • DESC (decrescente, padrão)
curl --request GET \
  --url 'https://api.pagou.ai/pix/v1/transactions?period=15&page=1&limit=10&order=DESC' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'apiKey: <sua-api-key>'

{
  "items": [
    {
      "id": "cb3e7f07-e7fd-4785-92c2-1abc281cd46e",
      "value": 0.5,
      "fee": 0.01,
      "netValue": 0.49,
      "operationStatus": "ERROR",
      "endToEnd": null,
      "externalId": null,
      "paymentSettlementDate": null,
      "createdAt": "2025-06-06T14:12:50.598Z",
      "updatedAt": "2025-06-06T14:18:51.882Z"
    },
    {
      "id": "1b501dd6-9182-49a6-8080-a9d2112b5c7c",
      "value": 0.1,
      "fee": 0.01,
      "netValue": 0.09,
      "operationStatus": "WAITING_CONFIRMATION",
      "endToEnd": null,
      "externalId": null,
      "paymentSettlementDate": null,
      "createdAt": "2025-06-06T14:39:24.001Z",
      "updatedAt": "2025-06-06T14:39:24.001Z"
    }
    // ... mais itens ...
  ],
  "total": 15,
  "totalPages": 3
}

​
Campos da Resposta

​
items
array
required
Lista de objetos de transação.
​
total
number
required
Número total de transações que correspondem à consulta.
​
totalPages
number
required
Número total de páginas disponíveis.
⌘I