Skip to main content
Request cancellation of one MED case in the selected payer-side owner scope.

Endpoint

POST /v3/med/cancel

Authentication and target

Use an account credential for its bound account, or a user credential with both X-ISPB and X-Account-Number. If an account credential sends those headers, both must be present and must match its bound account. Platform credentials are not accepted. All requests require the standard HMAC-SHA256 headers. The selected account determines payer-side MED owner scope; receiver-side operations are not exposed by these routes. The curl example below uses an ACCOUNT credential bound to the operated account, so it omits X-ISPB and X-Account-Number. If X-Client-ID identifies a USER credential, add both target headers and include their exact trimmed values in the canonical header set before calculating X-Signature.

Request body

Success data

The current post-cancellation med_case detail projection.

Behavior and validation

The Open API layer does not locally test can_cancel; the MED service decides whether the operation is allowed. Do not infer a time limit. The returned numeric status and can_cancel value are authoritative. No endpoint idempotency key exists.

Errors

Every call can fail for missing or invalid signature headers, an expired timestamp, nonce replay, an invalid body hash or signature, insufficient permission, or a downstream service error. Endpoint-specific errors include:
  • 4000 missing case ID.
  • Common owner-scope, MED RPC, and mapped provider errors.

Example request

Example response