---
title: "Cancel a signing request"
method: POST
path: "/signing-requests/{id}/cancel"
tags: ["Signing Requests"]
---

# Cancel a signing request

`POST /signing-requests/{id}/cancel`

Cancels a signing request that hasn't been completed yet. Can only cancel requests that have been sent and are not already finished or cancelled.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `reason` string — Optional cancellation reason
  - `notify_signers` boolean — Whether to notify signers of cancellation

## Response `200`

Signing request cancelled successfully

- CancelSigningRequestResponse — Signing request cancellation result
  - `message` string, required
  - `signing_request_id` string, uuid, required
  - `cancelled_on` string, date-time, required
  - `notify_signers` boolean
  - `emails_sent` integer — Number of cancellation notification emails sent to signers

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist
- `409` — Cannot cancel (already cancelled, finished, or not sent)
- `429` — Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/firma/apis/firma-partner-api.md) · [All operations](https://skmtc.dev/firma/apis/firma-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firma/firma-partner-api/revisions/5c03d6a9d080/schema)