MED Details

Queries the complete details of a specific MED (Special Return Mechanism) process.

Endpoint

GET /api/v2/external/med/:id

Headers

Header	Type	Required	Description
Authorization	String	Yes	Bearer {access_token}

Path Parameters

Parameter	Type	Required	Description
id	String	Yes	MED process identifier

Example

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

Success Response (200)

{
  "worked": true,
  "med": {
    "id": "MED20260307001",
    "type": "FRAUDE",
    "status": "accepted",
    "amount": 50000,
    "original_end_to_end_id": "E37839059202603071530000001",
    "original_transaction_id": "PIXIN20260307a1b2c3d4e5f6",
    "requester_ispb": "12345678",
    "reason": "Fraud reported by payer",
    "created_at": "2026-03-07T18:00:00Z",
    "tracking": {
      "notification_received": "2026-03-07T18:00:00Z",
      "funds_blocked": "2026-03-07T18:00:05Z",
      "analysis_completed": null,
      "refund_completed": null
    }
  }
}

Field	Type	Description
worked	Boolean	true indicates operation success
med.id	String	Unique MED identifier
med.type	String	Type: FRAUDE or FALHA_OPERACIONAL
med.status	String	Current process status
med.amount	Integer	Amount in cents
med.original_end_to_end_id	String	E2E of the original PIX transaction
med.original_transaction_id	String	Original PIX transaction ID
med.requester_ispb	String	Requesting institution ISPB
med.reason	String	Reason provided by the requester
med.created_at	String	Opening date (ISO 8601)
med.tracking	Object	Process stage history

Tracking fields

Field	Type	Description
notification_received	String	Date the MED notification was received
funds_blocked	String	Date funds were blocked (null if not blocked)
analysis_completed	String	Date analysis was completed (null if pending)
refund_completed	String	Date funds were returned (null if not refunded)

Error Response (404)

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

Error Response (401)

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

Tracking

Use Webhooks with the pix.med event to be notified about MED status changes in real time.