List MED

Lists MED (Special Return Mechanism) processes associated with the account.

MED is a Central Bank mechanism for recovering funds in cases of fraud or operational failure in the PIX system.

Endpoint

GET /api/v2/external/med

Headers

Header	Type	Required	Description
Authorization	String	Yes	Bearer {access_token}

Example

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

Success Response (200)

{
  "worked": true,
  "meds": [
    {
      "id": "MED20260307001",
      "type": "FRAUDE",
      "status": "pending",
      "amount": 50000,
      "original_end_to_end_id": "E37839059202603071530000001",
      "created_at": "2026-03-07T18:00:00Z"
    },
    {
      "id": "MED20260305002",
      "type": "FALHA_OPERACIONAL",
      "status": "refunded",
      "amount": 15000,
      "original_end_to_end_id": "E37839059202603051200000003",
      "created_at": "2026-03-05T14:30:00Z"
    }
  ]
}

Field	Type	Description
worked	Boolean	true indicates operation success
meds	Array	List of MED processes
meds[].id	String	Unique MED identifier
meds[].type	String	MED type (see table below)
meds[].status	String	Current process status
meds[].amount	Integer	Amount in cents
meds[].original_end_to_end_id	String	E2E of the original PIX transaction
meds[].created_at	String	Opening date (ISO 8601)

MED Types

Type	Description
FRAUDE	Suspected fraud or scam
FALHA_OPERACIONAL	System processing failure

MED Status

Status	Description
pending	MED under analysis
accepted	MED accepted -- funds blocked in the account
refunded	Funds returned to original payer
rejected	MED rejected after analysis
cancelled	MED cancelled

Success Response -- No MEDs (200)

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

Error Response (401)

{
  "worked": false,
  "detail": "Invalid or expired token"
}

Funds blocking

When a MED is accepted (accepted), the corresponding amounts are blocked in the account and deducted from the available balance. Track via MED Details and Webhook pix.med.