Overview
Authentication
Bank Account
Webhooks
Get Transfer Status
Copy
curl --request GET \
--url https://api.owem.com.br/v4/i/bank-accounts/{accountId}/transfer/external/{endToEnd} \
--header 'Authorization: <authorization>'Copy
{
"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": "EXAMPLE COMPANY LTD",
"agency": "0001",
"accountType": "checking",
"accountNumber": "123456789012"
},
"receiver": {
"ispb": "87654321",
"personType": "company",
"cpfCnpj": "XX654321000XXX",
"name": "DESTINATION COMMERCIAL LTD",
"agency": "0001",
"accountType": "savings",
"accountNumber": "300543881811"
},
"updatedAt": 1766523045000,
"updatedDate": "2025-12-24"
}
}
PIX OUT
Get Transfer Status
Returns the current status of a PIX OUT transfer. Check if the transfer was confirmed or failed.
GET
https://api.owem.com.br
/
v4
/
i
/
bank-accounts
/
{accountId}
/
transfer
/
external
/
{endToEnd}
Get Transfer Status
Copy
curl --request GET \
--url https://api.owem.com.br/v4/i/bank-accounts/{accountId}/transfer/external/{endToEnd} \
--header 'Authorization: <authorization>'Copy
{
"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": "EXAMPLE COMPANY LTD",
"agency": "0001",
"accountType": "checking",
"accountNumber": "123456789012"
},
"receiver": {
"ispb": "87654321",
"personType": "company",
"cpfCnpj": "XX654321000XXX",
"name": "DESTINATION COMMERCIAL LTD",
"agency": "0001",
"accountType": "savings",
"accountNumber": "300543881811"
},
"updatedAt": 1766523045000,
"updatedDate": "2025-12-24"
}
}
Purpose
Returns the current status of a PIX OUT transfer by EndToEndId, with a summarized view of the entry.Authentication
Basic Auth required in format:
Basic {Base64(API_KEY:API_SECRET)}Path Parameters
Source account at Owem
PIX EndToEndId of the queried operation
Response
UUID for tracking
Operation status
Number of returned items
Show data
Show data
processing, succeeded, or failedGross transfer amount (BRL)
PIX E2E operation identifier
Last update timestamp (ms)
Last update date (YYYY-MM-DD)
Copy
{
"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": "EXAMPLE COMPANY LTD",
"agency": "0001",
"accountType": "checking",
"accountNumber": "123456789012"
},
"receiver": {
"ispb": "87654321",
"personType": "company",
"cpfCnpj": "XX654321000XXX",
"name": "DESTINATION COMMERCIAL LTD",
"agency": "0001",
"accountType": "savings",
"accountNumber": "300543881811"
},
"updatedAt": 1766523045000,
"updatedDate": "2025-12-24"
}
}
Status Codes
| HTTP | Description |
|---|---|
| 200 | Valid query |
| 400 | Malformed parameter |
| 401 | Invalid credentials |
| 403 | IP not allowlisted |
| 404 | EndToEndId not found |
| 429 | Rate limit exceeded |
| 500 | Internal error |
Transfer Status
| Status | Description |
|---|---|
processing | Registered, awaiting bank confirmation |
succeeded | Transfer confirmed |
failed | Failed (invalid key, bank rejection) |
For complete accounting reconciliation, query the Ledger via
GET /v4/i/ledger/end-to-end/:endToEndId.If status remains
processing longer than expected, investigate via Ledger or
webhook events (pix.out.succeeded/pix.out.failed).Was this page helpful?
⌘I