Pular para o conteúdo principal
GET
https://api.owem.com.br
/
v4
/
i
/
bank-accounts
/
{accountId}
/
transfer
/
external
/
{endToEnd}
Consultar Status da Transferência
curl --request GET \
  --url https://api.owem.com.br/v4/i/bank-accounts/{accountId}/transfer/external/{endToEnd} \
  --header 'Authorization: <authorization>'
{
  "requestId": "a111b222-c333-4d44-8e55-f66677788899",
  "success": true,
  "size": 1,
  "data": {
    "status": "succeeded",
    "grossAmount": 585.0,
    "endToEndId": "E123456789202512240000000000001",
    "payer": {
      "ispb": "12345678",
      "personType": "company",
      "cpfCnpj": "XX123456000XXX",
      "name": "EMPRESA EXEMPLO LTDA",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "123456789012"
    },
    "receiver": {
      "ispb": "87654321",
      "personType": "company",
      "cpfCnpj": "XX654321000XXX",
      "name": "DESTINATARIO COMERCIAL LTDA",
      "agency": "0001",
      "accountType": "savings",
      "accountNumber": "300543881811"
    },
    "updatedAt": 1766523045000,
    "updatedDate": "2025-12-24"
  }
}

​
Finalidade

Retorna o status atual de uma transferência PIX OUT por EndToEndId, com visão resumida do lançamento.

​
Autenticação

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

​
Path Parameters

​
accountId
string
obrigatório
Conta de origem da transferência na Owem
​
endToEnd
string
obrigatório
EndToEndId PIX da operação consultada

​
Resposta

​
requestId
string
UUID para rastreio
​
success
boolean
Status da operação
​
size
number
Quantidade de itens retornados
​
data
object
{
  "requestId": "a111b222-c333-4d44-8e55-f66677788899",
  "success": true,
  "size": 1,
  "data": {
    "status": "succeeded",
    "grossAmount": 585.0,
    "endToEndId": "E123456789202512240000000000001",
    "payer": {
      "ispb": "12345678",
      "personType": "company",
      "cpfCnpj": "XX123456000XXX",
      "name": "EMPRESA EXEMPLO LTDA",
      "agency": "0001",
      "accountType": "checking",
      "accountNumber": "123456789012"
    },
    "receiver": {
      "ispb": "87654321",
      "personType": "company",
      "cpfCnpj": "XX654321000XXX",
      "name": "DESTINATARIO COMERCIAL LTDA",
      "agency": "0001",
      "accountType": "savings",
      "accountNumber": "300543881811"
    },
    "updatedAt": 1766523045000,
    "updatedDate": "2025-12-24"
  }
}

​
Códigos de Status

HTTPDescrição
200Consulta válida
400Parâmetro malformado
401Credenciais inválidas
403IP não allowlisted
404EndToEndId não encontrado
429Rate limit excedido
500Erro interno

​
Status da Transferência

StatusDescrição
processingRegistrada, aguardando confirmação bancária
succeededTransferência confirmada
failedFalha (chave inválida, rejeição bancária)
Para conciliação contábil completa, consulte o Ledger via GET /v4/i/ledger/end-to-end/:endToEndId.
Se o status permanecer processing além do esperado, investigue via Ledger ou eventos de webhook (pix.out.succeeded/pix.out.failed).