---
title: "Cancel signature request (eSignatures API)"
method: POST
path: "/signatures/cancel"
tags: ["Document AI — E-Signatures"]
---

# Cancel signature request (eSignatures API)

`POST /signatures/cancel`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/signatures/cancel`
- Auth: HTTP bearer

WHEN TO USE: cancel a signature request that was created with po_esignatures_create_signature_request. For a signing LINK created with po_signature_links_send_signing_request use po_signature_links_cancel_signing_request. If you do not...

## Request body

- object
  - `signature_id` string, required: Signature request ID: the `uuid` (also `request.signature_id`) returned by POST /signatures/create. Aliases: request_uuid, uuid, request_id.
  - `request_uuid` string: Alias for signature_id (send instead of signature_id, not in addition with a different value).
  - `uuid` string: Alias for signature_id (send instead of signature_id, not in addition with a different value).
  - `request_id` integer: Numeric `request.id` from /signatures/create (used only when no UUID field is sent).
  - `reason` string: Optional cancellation reason.

## Response `200`

Success

- object: Unterschriftsanfrage stornieren
  - `status` 'success' | 'error', required: HTTP-Level Status
  - `job_id` string, required
  - `message` string: Menschenlesbare Statusmeldung
  - `pipeline` string
  - `operation` string: Ausgefuehrte Operation
  - `processing_time` string: Gesamte Verarbeitungszeit inkl. Queue (Format: 123.45ms)
  - `result` object, required: Das eigentliche Verarbeitungsergebnis
    - `status` 'completed' | 'failed' | 'timeout': Job-Level Status
    - `message` string: Pipeline-spezifische Statusmeldung
    - `duration_ms` string: Reine Pipeline-Verarbeitungszeit in ms
    - `output` object
      - `cancelled` boolean
      - `signature_id` string

## Other responses

- `4XX`: Error
- `5XX`: Error

---

[API](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api.md) · [All operations](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/revisions/c6a6228a4509?raw)