---
title: "Cancel Prior Auth Submission By Id"
method: POST
path: "/prior-authorization/{id}/cancel"
tags: ["public-api", "public-api"]
---

# Cancel Prior Auth Submission By Id

`POST /prior-authorization/{id}/cancel`

Cancel a prior authorization request.

The request must not already be in a terminal state (`completed`, `failed`,
or `cancelled`). Requires a `cancellation_reason` payload which is stored
for analytics.

## Path parameters

- `id` string, required

## Request body

- CancelPriorAuthRequest — Request to cancel a prior authorization.
  - `cancellation_reason` string, required — Reason for cancellation. This is used for analytics purposes.

## Response `200`

Successfully cancelled a prior authorization

- CancelPriorAuthResponse — Represents the response structure for a POST /prior-authorization/:id/cancellation request. This response is returned when a prior authorization is successfully cancelled.
  - `status` union
    - 'success'
    - 'error'
  - `error` ApiError
    - `title` string, required
    - `description` string, required
    - `code` string, required
  - `data` unknown

## Other responses

- `400` — Cannot cancel a prior authorization in completed, failed, or cancelled state
- `404` — Prior Authorization Request does not exist
- `422` — Validation Error

---

[API](https://skmtc.net/develophealth/apis/develop-health-public-api.md) · [All operations](https://skmtc.net/develophealth/apis/develop-health-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/develophealth/develop-health-public-api/revisions/1684e1dda9be/schema)