Skip to main content
GET
/
account
/
transactions
curl -X GET 'https://api.goatpay.com.br/v1/account/transactions?page=1&pageSize=50' \
  -H 'X-API-Key: gp_live_SUA_CHAVE'

{
  "success": true,
  "message": "Extrato consultado com sucesso",
  "data": {
    "items": [
      {
        "id": "clx_pix_in",
        "type": "PIX_IN",
        "status": "COMPLETED",
        "amount": 100,
        "feeAmount": 3.5,
        "netAmount": 96.5,
        "coverFee": false,
        "currency": "BRL",
        "description": "Pedido 123",
        "externalReference": "pedido-123",
        "referenceId": "txid_abc",
        "endToEndId": "E12345678202505301234567890123456",
        "completedAt": "2026-06-01T12:30:00.000Z",
        "createdAt": "2026-06-01T12:00:00.000Z"
      }
    ],
    "page": 1,
    "pageSize": 50,
    "total": 0,
    "pages": 1
  },
  "requestId": "req_abc"
}

curl -X GET 'https://api.goatpay.com.br/v1/account/transactions?page=1&pageSize=50' \
  -H 'X-API-Key: gp_live_SUA_CHAVE'

{
  "success": true,
  "message": "Extrato consultado com sucesso",
  "data": {
    "items": [
      {
        "id": "clx_pix_in",
        "type": "PIX_IN",
        "status": "COMPLETED",
        "amount": 100,
        "feeAmount": 3.5,
        "netAmount": 96.5,
        "coverFee": false,
        "currency": "BRL",
        "description": "Pedido 123",
        "externalReference": "pedido-123",
        "referenceId": "txid_abc",
        "endToEndId": "E12345678202505301234567890123456",
        "completedAt": "2026-06-01T12:30:00.000Z",
        "createdAt": "2026-06-01T12:00:00.000Z"
      }
    ],
    "page": 1,
    "pageSize": 50,
    "total": 0,
    "pages": 1
  },
  "requestId": "req_abc"
}
Itens não incluem provider, accountId, direction, metadata nem updatedAt. Use referenceId para conciliar com o processador.

​
Parâmetros de query

​
page
number
Número da página (padrão 1).
​
pageSize
number
Itens por página (padrão 50, máximo 100).
​
dateFrom
string
ISO 8601 — início do período (createdAt).
​
dateTo
string
ISO 8601 — fim do período (createdAt).
​
status
string
PENDING, PROCESSING, COMPLETED, FAILED, CANCELED ou REVERSED.
​
externalReference
string
Filtro exato pela referência externa.
​
search
string
Busca parcial em id, description, externalReference, endToEndId, referenceId e pixKey.
​
subaccountId
string
Filtra apenas transações vinculadas à subconta merchant. Alias: merchantSubaccountId. Com este filtro, o trilho PIX da API key é ignorado.
​
merchantSubaccountId
string
Mesmo filtro que subaccountId (PIX com subconta, transferências internas entre subs, MED/reembolso, etc.).
​
type
string
entrada ou saida (direção CREDIT/DEBIT).
​
method
string
PIX, Cartão, Boleto, Cripto, TED ou Interna.

Authorizations

​
X-API-Key
string
header
required

Chave gp_live_... criada em Integrações → Chaves de API no dashboard.

Query Parameters

​
page
integer
default:1
Required range: x >= 1
​
pageSize
integer
default:50
Required range: 1 <= x <= 100
​
dateFrom
string<date-time>
​
dateTo
string<date-time>
​
status
enum<string>
Available options:
PENDING,
PROCESSING,
COMPLETED,
FAILED,
CANCELED,
REVERSED
​
externalReference
string
​
search
string

Busca parcial em id, description, externalReference, endToEndId, referenceId e pixKey.

​
subaccountId
string

Filtra transações vinculadas à subconta merchant (PIX com subaccountId na criação, movimentações internas, MED/reembolso, etc.). Alias de merchantSubaccountId. Quando informado, o filtro de trilho PIX da API key é ignorado.

​
merchantSubaccountId
string

Mesmo filtro que subaccountId.

​
type
enum<string>
Available options:
entrada,
saida
​
method
enum<string>
Available options:
PIX,
Cartão,
Boleto,
Cripto,
TED,
Interna

Response

200 - application/json

Lista paginada de transações.

​
success
boolean
required
​
message
string
required
​
data
object
required
​
requestId
string