Listar MEDs

Lista os casos de MED ligados aos pagamentos da empresa.

GET/v1/med

https://integrate.api.kyvopay.com.br

cURL

curl -X GET "https://api.kyvopay.com.br/v1/med?page=1&per_page=25" \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN" \
  -H "X-Business-Id: UUID_DA_EMPRESA"

Resposta200 OK

{
  "data": {
    "items": [{
      "id": "med_...",
      "payment_id": "pay_...",
      "provider_med_id": "...",
      "amount_centavos": "10000",
      "status": "open",
      "reason": null,
      "end_to_end_id": "E...",
      "opened_at": "2026-09-24T12:00:00.000Z",
      "resolved_at": null,
      "created_at": "2026-09-24T12:00:00.000Z"
    }],
    "total": 1,
    "page": 1,
    "per_page": 25
  },
  "error": null,
  "request_id": "req_..."
}

Autenticação

X-API-Keystring · headerobrigatório

Use a chave ky_... criada em Integrações → Chaves de API no painel KyvoPay.

Lista os casos de MED ligados aos pagamentos da empresa. Permite filtrar por status e paginar os resultados.

Requisição

Query

statusstring

open, accepted, rejected ou cancelled.

pageinteger

Padrão 1.

per_pageinteger

Máximo 100; padrão 25.

Precisa de ajuda? Fale com o suporte