Query Cash Out by Tag

Queries PIX transactions matching a tag (prefix of transaction_id). Allows grouping and searching transactions by date, type, or any identifier prefix.

Endpoint

GET /api/external/transactions/tag/:tag

Headers

Header	Type	Required	Description
Authorization	String	Yes	ApiKey {client_id}:{client_secret}

Path Parameters

Parameter	Type	Required	Description
tag	String	Yes	transaction_id prefix for search

Tag search examples

• PIXOUT20260309 -- all outbound PIX transfers from 2026-03-09
• PIXOUT -- all outbound PIX transfers
• PIXIN20260309 -- all PIX receipts from 2026-03-09

Example

curl -X GET https://api.owem.com.br/api/external/transactions/tag/PIXOUT20260309 \
  -H "Authorization: ApiKey $CLIENT_ID:$CLIENT_SECRET"

Success Response -- 200

{
  "worked": true,
  "data": [
    {
      "id": "c7f3a8b1-2d4e-4f6a-9c1b-3e5f7a9b1d3e",
      "transaction_id": "PIXOUT20260309a1b2c3d4e5f6",
      "end_to_end_id": "E37839059202603091530abcdef01",
      "external_id": "order-9876",
      "type": "pix",
      "direction": "outbound",
      "status": "completed",
      "amount": 300000,
      "fee_amount": 350,
      "net_amount": 300350,
      "description": "Pagamento fornecedor",
      "counterparty_name": "Joao Silva",
      "recipient_key": "12345678901",
      "created_at": "2026-03-09T15:30:00Z",
      "completed_at": "2026-03-09T15:30:02Z"
    },
    {
      "id": "d8e4b9c2-3f5a-5b7c-0d2e-4f6a8b0c2e4f",
      "transaction_id": "PIXOUT20260309f6e5d4c3b2a1",
      "end_to_end_id": "E37839059202603091545abcdef02",
      "external_id": null,
      "type": "pix",
      "direction": "outbound",
      "status": "processing",
      "amount": 2500000,
      "fee_amount": 350,
      "net_amount": 2500350,
      "description": "Pagamento servico",
      "counterparty_name": "Maria Santos",
      "recipient_key": "98765432100",
      "created_at": "2026-03-09T15:45:00Z",
      "completed_at": null
    }
  ]
}

Field	Type	Description
data	Array	List of transactions matching the prefix

Each object in the array follows the same structure as the query by ID. Monetary values are in base units (/ 10,000 for BRL).

Result limit

The tag search returns a maximum of 50 transactions per request. Use more specific prefixes (e.g., full date) to refine results.

Empty Response -- 200

When no transactions match the provided prefix:

{
  "worked": true,
  "data": []
}