Pular para o conteúdo principal
GET
https://api.owem.com.br
/
v4
/
i
/
ledger
/
end-to-end
/
{endToEndId}
Consultar por EndToEndId
curl --request GET \
  --url https://api.owem.com.br/v4/i/ledger/end-to-end/{endToEndId} \
  --header 'Authorization: <authorization>'
{
  "requestId": "2b49f82a-bca7-4774-ac2c-3b3733ad6a49",
  "success": true,
  "size": 1,
  "message": "Ledger consultado",
  "data": {
    "id": "E123456789202512230000000000003",
    "type": "debit",
    "reason": "pix_out:processing",
    "status": "succeeded",
    "grossAmount": 750.0,
    "feeAmount": 0,
    "netAmount": 750.0,
    "externalId": "TX-20251223-PIX-002",
    "endToEndId": "E123456789202512230000000000003",
    "entryId": null,
    "accountId": "123456789012",
    "userId": "usr_abc123def",
    "requestId": "M000000000a202512230000000000003",
    "createdAt": 1766523042000,
    "createdDate": "2025-12-23",
    "updatedAt": 1766533845420,
    "updatedDate": "2025-12-23",
    "metadata": {
      "idempotencyKey": "1766523039000-abc12345"
    },
    "idempotencyKey": "debit:pix_out:processing:E123456789202512230000000000003",
    "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"
    },
    "uid": "E123456789202512230000000000003"
  }
}

Finalidade

Este endpoint permite consultar uma entrada contábil pelo identificador PIX (E2E).

Autenticação

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

Path Parameters

endToEndId
string
obrigatório
Identificador PIX (E2E). Deve ser o valor completo retornado pelo banco. Formato típico: 32+ caracteres alfanuméricos (varia por emissor)

Resposta

requestId
string
UUID para rastreio
success
boolean
Status da operação
size
number
Quantidade de registros
message
string
Mensagem descritiva (ex: “Ledger consultado”)
data
object
{
  "requestId": "2b49f82a-bca7-4774-ac2c-3b3733ad6a49",
  "success": true,
  "size": 1,
  "message": "Ledger consultado",
  "data": {
    "id": "E123456789202512230000000000003",
    "type": "debit",
    "reason": "pix_out:processing",
    "status": "succeeded",
    "grossAmount": 750.0,
    "feeAmount": 0,
    "netAmount": 750.0,
    "externalId": "TX-20251223-PIX-002",
    "endToEndId": "E123456789202512230000000000003",
    "entryId": null,
    "accountId": "123456789012",
    "userId": "usr_abc123def",
    "requestId": "M000000000a202512230000000000003",
    "createdAt": 1766523042000,
    "createdDate": "2025-12-23",
    "updatedAt": 1766533845420,
    "updatedDate": "2025-12-23",
    "metadata": {
      "idempotencyKey": "1766523039000-abc12345"
    },
    "idempotencyKey": "debit:pix_out:processing:E123456789202512230000000000003",
    "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"
    },
    "uid": "E123456789202512230000000000003"
  }
}

Códigos de Status

HTTPDescrição
200Sucesso
400endToEndId malformado
401Credenciais inválidas
403IP não allowlisted
404Entrada não encontrada
429Rate limit excedido
500Erro interno
O endToEndId é o identificador único gerado pelo sistema bancário para cada transação PIX.