Financeiro

Listar transações

GET/v1/transactionstransactions:read

Cabeçalhos

Authorizationstringobrigatório

Bearer seguido da sua chave: gw_test_ em teste, gw_live_ em produção.

Parâmetros de consulta

limitinteger · 1–100opcional

cursorstring · 1–512opcional

Cursor opaco devolvido pela página anterior.

statusstringopcional

CREATINGPENDINGPAIDFAILEDCANCELEDEXPIREDUNDER_REVIEWREVERSED

Resposta 200

Página de transações

dataobject[]

13 campos

iduuid

external_idstring

type"CASH_IN"

method"PIX"

currency"BRL"

statusstring

CREATINGPENDINGPAIDFAILEDCANCELEDEXPIREDUNDER_REVIEWREVERSED

amount_centsinteger

Valor inteiro em centavos.

fee_centsinteger

Valor inteiro em centavos.

net_amount_centsinteger

Valor inteiro em centavos.

paid_atdatetime | null

expires_atdatetime | null

created_atdatetime

updated_atdatetime

next_cursorstring | null

Códigos de resposta

HTTP	Quando acontece
200	Página de transações
400	Requisição ou cursor inválido
401	Chave ausente, inválida ou sem o escopo exigido
429	Limite de requisições excedido

Cada código de erro está explicado em Erros.

Requisição

curl -X GET "https://api.mainumpay.com/v1/transactions" \
  -H "Authorization: Bearer $MAINUM_API_KEY"

Resposta

{
  "data": [
    {
      "id": "0192a7c4-5b1e-7d3a-9f10-6c2e8b4d1a77",
      "external_id": "pedido-48213",
      "type": "CASH_IN",
      "method": "PIX",
      "currency": "BRL",
      "status": "PAID",
      "amount_cents": 4990,
      "fee_cents": 149,
      "net_amount_cents": 4841,
      "paid_at": "2026-09-24T14:35:48.000Z",
      "expires_at": "2026-09-24T15:02:11.000Z",
      "created_at": "2026-09-24T14:32:11.000Z",
      "updated_at": "2026-09-24T14:35:49.000Z"
    }
  ],
  "next_cursor": null,
  "request_id": "req_0192a7c4-5b20-7c11-8e4f-2b9d0c6a3e58"
}

Página de transações