Listar pedidos de MED

Os pedidos de devolução (MED-) abertos contra Pix recebidos na conta, do mais novo para o mais antigo.

GET /v1/meds

cURL

curl "https://bukio-backend-production.up.railway.app/v1/meds?limit=20&status=open,analysis" \
  -H "Authorization: Bearer bk_live_..."

200

{
  "items": [
    {
      "id": "MED-5Q2W8M4Z3F7K",
      "original": { "id": "BKY-7KQ2M9XP4RZT", "payerName": "Ana Souza", "institution": "Banco Exemplo" },
      "status": "open",
      "statusTitle": "Aberto",
      "amount": 15000,
      "blocked": 15000,
      "owed": 0,
      "fee": 0,
      "receivedFee": 100,
      "receivedFeeOwed": 0,
      "reason": "fraud",
      "reasonTitle": "Fraude",
      "description": "Pagador alega não reconhecer a compra.",
      "deadline": "2026-10-15T15:04:11.000Z",
      "defense": null,
      "attachments": [],
      "decisionNote": null,
      "defenseAt": null,
      "decidedAt": null,
      "createdAt": "2026-10-08T15:04:11.000Z"
    }
  ],
  "nextCursor": null
}

Escopo meds:list. A defesa de um pedido é enviada no painel; pela API você acompanha.

limit · integer · default: "50"

De 1 a 100.

cursor · string

O nextCursor da página anterior.

status · string

Só os pedidos nestas situações, separadas por vírgula: open (Aberto), analysis (Em análise), rejected (Contestado) e refunded (Devolvido). Ex.: open,analysis para os que ainda não foram decididos. O filtro vale para a lista inteira, com o cursor.

​

Resposta

items · object[]

Cada item no formato de Consultar pedido de MED.

nextCursor · string | null

Próxima página; null quando acabou.

cURL

curl "https://bukio-backend-production.up.railway.app/v1/meds?limit=20&status=open,analysis" \
  -H "Authorization: Bearer bk_live_..."

200

{
  "items": [
    {
      "id": "MED-5Q2W8M4Z3F7K",
      "original": { "id": "BKY-7KQ2M9XP4RZT", "payerName": "Ana Souza", "institution": "Banco Exemplo" },
      "status": "open",
      "statusTitle": "Aberto",
      "amount": 15000,
      "blocked": 15000,
      "owed": 0,
      "fee": 0,
      "receivedFee": 100,
      "receivedFeeOwed": 0,
      "reason": "fraud",
      "reasonTitle": "Fraude",
      "description": "Pagador alega não reconhecer a compra.",
      "deadline": "2026-10-15T15:04:11.000Z",
      "defense": null,
      "attachments": [],
      "decisionNote": null,
      "defenseAt": null,
      "decidedAt": null,
      "createdAt": "2026-10-08T15:04:11.000Z"
    }
  ],
  "nextCursor": null
}