> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wyzecash.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar pedido de MED

> Um pedido de devolução: valor, quanto está bloqueado, prazo, defesa e decisão.

Escopo `transactions:read`. De outra conta: `404 NOT_FOUND`.

**id** `string` *required*

`MED-` + 12 caracteres.

## Resposta

**id** `string`

`MED-` + 12.

**original** `object | null`

O Pix recebido em disputa.

**propriedades**

**id** `string`

`BKY-` da cobrança.

**payerName** `string | null`

Quem pagou.

**institution** `string | null`

Banco de quem pagou.

**status** `string`

`open`, `analysis`, `refunded` ou `rejected`.

**statusTitle** `string`

Aberto, Em análise, Devolvido ou Contestado (você ganhou).

**amount** `integer`

Valor pedido.

**blocked** `integer`

Quanto está bloqueado agora (pode ser menor que `amount` se o saldo não cobria tudo).

**owed** `integer`

Devolvido sem saldo suficiente: o que ainda falta e sai dos próximos recebimentos.

**fee** `integer`

Contestado: tarifa descontada ao liberar o bloqueio.

**receivedFee** `integer`

Taxa de MED recebido, cobrada quando o pedido chegou.

**receivedFeeOwed** `integer`

Quanto dessa taxa ainda falta pagar.

**reason** `string`

`fraud`, `scam` ou `operational`.

**reasonTitle** `string`

Fraude, Golpe ou Falha operacional.

**description** `string | null`

O que o banco de quem pagou alegou.

**deadline** `string`

Prazo para enviar a defesa.

**defense** `string | null`

A defesa enviada no painel.

**attachments** `object[]`

Provas anexadas à defesa (`id`, nome, tipo, tamanho). O arquivo não se baixa pela API: fica guardado com a WyzeCash. Para responder com as provas, use [Responder MED](https://docs.wyzecash.com.br/referencia/med/responder-med.md).

**decisionNote** `string | null`

Motivo da decisão, quando houver.

**defenseAt** `string | null`

Quando a defesa foi enviada.

**decidedAt** `string | null`

Quando foi decidido.

**createdAt** `string`

Quando o pedido chegou.

```bash cURL theme={null}
curl https://api.wyzecash.com.br/v1/meds/MED-5Q2W8M4Z3F7K \
  -H "Authorization: Bearer bk_live_..."
```

```json 200 theme={null}
{
  "id": "MED-5Q2W8M4Z3F7K",
  "original": { "id": "BKY-7KQ2M9XP4RZT", "payerName": "Ana Souza", "institution": "Banco Exemplo" },
  "status": "rejected",
  "statusTitle": "Contestado",
  "amount": 15000,
  "blocked": 0,
  "owed": 0,
  "fee": 50,
  "receivedFee": 100,
  "receivedFeeOwed": 0,
  "reason": "fraud",
  "reasonTitle": "Fraude",
  "description": "Pagador alega não reconhecer a compra.",
  "deadline": "2026-10-15T15:04:11.000Z",
  "defense": "Pedido 1842 entregue em 09/10 com assinatura do destinatário.",
  "attachments": [ { "id": "3f2a1b0c-9d8e-4f7a-b6c5-d4e3f2a1b0c9", "name": "comprovante-entrega.pdf", "type": "application/pdf", "size": 182334 } ],
  "decisionNote": null,
  "defenseAt": "2026-10-09T10:00:00.000Z",
  "decidedAt": "2026-10-12T16:30:00.000Z",
  "createdAt": "2026-10-08T15:04:11.000Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.