List MED cases

List MED cases. See the request, response and integration notes.

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": [],
    "page": 1,
    "per_page": 25,
    "total": 0
  },
  "error": null,
  "request_id": "req_..."
}

Authentication

X-API-Keystring · headerrequired

Use the ky_... key created under Integrations → API Keys in the KyvoPay dashboard.

Use this endpoint to list med cases.

Request

Private endpoints require the X-API-Key header. Keep credentials on your backend and log the response request_id for diagnostics.

Response

Implementation notes

Validate required input before sending the request.
Store returned public identifiers without assuming their format.
Treat 4xx validation errors as non-retryable until the request is corrected.
Retry timeouts, 429 and temporary 5xx responses with exponential backoff.

Need help? Contact support