Pular para o conteúdo principal
GET
https://api.owem.com.br
/
v4
/
i
/
ledger
Consulta na Ledger
curl --request GET \
  --url https://api.owem.com.br/v4/i/ledger \
  --header 'Authorization: <authorization>'
{
  "requestId": "25ff16ac-80da-47a9-958d-58b8ff435afd",
  "success": true,
  "size": 1,
  "pagination": {
    "page": 1,
    "limit": 10,
    "orderBy": "desc",
    "total": 1,
    "totalPages": 1
  },
  "data": [
    {
      "id": "E123456789202512230000000000001",
      "type": "debit",
      "reason": "pix_out:processing",
      "status": "succeeded",
      "grossAmount": 0.01,
      "feeAmount": 0,
      "netAmount": 0.01,
      "externalId": "TX-20251223-TEST-001",
      "endToEndId": "E123456789202512230000000000001",
      "entryId": null,
      "accountId": "123456789012",
      "userId": "usr_abc123def",
      "requestId": "M000000000a202512230000000000001",
      "createdAt": 1766523042000,
      "createdDate": "2025-12-23",
      "updatedAt": 1766523045000,
      "updatedDate": "2025-12-23",
      "metadata": {
        "idempotencyKey": "1766523039000-abc12345"
      },
      "idempotencyKey": "debit:pix_out:processing:E123456789202512230000000000001",
      "parentEndToEndId": null,
      "refundedEndToEndId": null,
      "medId": null,
      "medCreatedAt": null,
      "medCreatedDate": null,
      "errorMessage": null,
      "payer": {
        "ispb": "12345678",
        "personType": "company",
        "cpfCnpj": "XX123456000XXX",
        "name": "EMPRESA EXEMPLO LTDA",
        "agency": "0001",
        "accountType": "checking",
        "accountNumber": "123456789012"
      },
      "receiver": {
        "ispb": "87654321",
        "personType": "person",
        "cpfCnpj": "XXX123456XX",
        "name": "JOAO DA SILVA",
        "agency": "0001",
        "accountType": "CACC",
        "accountNumber": "00000000000012345678"
      }
    }
  ]
}

​
Finalidade

Este endpoint permite consultar o histórico contábil completo (ledger) de uma conta.

​
Autenticação

​
Authorization
string
obrigatório
Basic Auth obrigatório no formato: Basic {Base64(API_KEY:API_SECRET)}

​
Query Parameters

​
type
string
Tipo da operação. Valores: debit, credit
​
reason
string
Filtra pela razão da operação. Valores possíveis: - pix_in:qrcode_paid - pix_in:credited - pix_out:processing - pix_in:refunded_processing - pix_out:refunded_processing
​
status
string
Status da operação. Valores: processing, succeeded, failed
​
startDate
number
Timestamp inicial (em milissegundos)
​
endDate
number
Timestamp final (em milissegundos)
​
page
number
padrão:"1"
Página de resultados
​
limit
number
padrão:"100"
Quantidade máxima de registros (máx. 100)

​
Resposta

​
requestId
string
UUID para rastreio
​
success
boolean
Status da operação
​
size
number
Quantidade de registros retornados
​
pagination
object
​
data
array
{
  "requestId": "25ff16ac-80da-47a9-958d-58b8ff435afd",
  "success": true,
  "size": 1,
  "pagination": {
    "page": 1,
    "limit": 10,
    "orderBy": "desc",
    "total": 1,
    "totalPages": 1
  },
  "data": [
    {
      "id": "E123456789202512230000000000001",
      "type": "debit",
      "reason": "pix_out:processing",
      "status": "succeeded",
      "grossAmount": 0.01,
      "feeAmount": 0,
      "netAmount": 0.01,
      "externalId": "TX-20251223-TEST-001",
      "endToEndId": "E123456789202512230000000000001",
      "entryId": null,
      "accountId": "123456789012",
      "userId": "usr_abc123def",
      "requestId": "M000000000a202512230000000000001",
      "createdAt": 1766523042000,
      "createdDate": "2025-12-23",
      "updatedAt": 1766523045000,
      "updatedDate": "2025-12-23",
      "metadata": {
        "idempotencyKey": "1766523039000-abc12345"
      },
      "idempotencyKey": "debit:pix_out:processing:E123456789202512230000000000001",
      "parentEndToEndId": null,
      "refundedEndToEndId": null,
      "medId": null,
      "medCreatedAt": null,
      "medCreatedDate": null,
      "errorMessage": null,
      "payer": {
        "ispb": "12345678",
        "personType": "company",
        "cpfCnpj": "XX123456000XXX",
        "name": "EMPRESA EXEMPLO LTDA",
        "agency": "0001",
        "accountType": "checking",
        "accountNumber": "123456789012"
      },
      "receiver": {
        "ispb": "87654321",
        "personType": "person",
        "cpfCnpj": "XXX123456XX",
        "name": "JOAO DA SILVA",
        "agency": "0001",
        "accountType": "CACC",
        "accountNumber": "00000000000012345678"
      }
    }
  ]
}

​
Códigos de Status

HTTPDescrição
200Sucesso
400Parâmetro inválido
401Credenciais inválidas
403IP não allowlisted
429Rate limit excedido
500Erro interno
O Ledger preserva o histórico completo de forma permanente e imutável. Use para reconciliação e auditoria.