Query Cash Out by ID

Queries the details and status of a PIX transaction by transaction_id.

Endpoint

GET /api/v2/external/transactions/{id}

Headers

Header	Type	Required	Description
Authorization	String	Yes	Bearer {access_token}

Path Parameters

Parameter	Type	Required	Description
id	String	Yes	Transaction ID (transaction_id)

Example

curl -X GET https://api.owem.com.br/api/v2/external/transactions/PIXOUT20260309a1b2c3d4e5f6 \
  -H "Authorization: Bearer $TOKEN"

Success Response — 200

{
  "worked": true,
  "data": {
    "id": "c7f3a8b1-2d4e-4f6a-9c1b-3e5f7a9b1d3e",
    "transaction_id": "PIXOUT20260309a1b2c3d4e5f6",
    "end_to_end_id": "E37839059202603091530abcdef01",
    "type": "pix",
    "direction": "outbound",
    "status": "completed",
    "amount": 10000,
    "fee": 0,
    "description": "Supplier payment",
    "payer": {
      "name": "Empresa Exemplo LTDA",
      "document": "12345678000199",
      "ispb": "37839059",
      "account": "100001"
    },
    "payee": {
      "name": "Joao Silva",
      "document": "***456789**",
      "ispb": "00000000",
      "account": "987654"
    },
    "created_at": "2026-03-09T15:30:00Z",
    "updated_at": "2026-03-09T15:30:02Z"
  }
}

Response Fields

Field	Type	Description
data.id	String	Internal transaction UUID
data.transaction_id	String	Unique transaction identifier
data.end_to_end_id	String	End-to-End identifier in SPI/BACEN
data.type	String	Transaction type (pix)
data.direction	String	Direction: outbound (cash-out) or inbound (cash-in)
data.status	String	Current status (see table below)
data.amount	Integer	Amount in cents
data.fee	Integer	Fee charged in cents
data.description	String	Description provided at creation
data.payer	Object	Payer data
data.payer.name	String	Payer name
data.payer.document	String	Payer CPF/CNPJ
data.payer.ispb	String	Payer institution ISPB
data.payer.account	String	Payer account
data.payee	Object	Payee data
data.payee.name	String	Payee name
data.payee.document	String	Payee CPF/CNPJ (masked)
data.payee.ispb	String	Payee institution ISPB
data.payee.account	String	Payee account
data.created_at	String	Creation date (ISO 8601)
data.updated_at	String	Last update date (ISO 8601)

Transaction Status

Status	Description
pending_approval	Awaiting approval (create + approve flow)
processing	Sent to SPI, awaiting settlement
completed	Successfully settled
failed	Rejected by SPI or processing error
refunded	Refunded (total or partial)

Error Response — 404

{
  "worked": false,
  "detail": "Transaction not found"
}