---
title: "Cancel funds recovery [beta]"
method: POST
path: "/v1/pix/funds-recoveries/{funds_recovery_id}/cancel"
tags: ["Funds recovery"]
---

# Cancel funds recovery \[beta\]

`POST /v1/pix/funds-recoveries/{funds_recovery_id}/cancel`

## Request

- Base URL: `https://sandbox.pismolabs.io/passport`
- URL: `https://sandbox.pismolabs.io/passport/v1/pix/funds-recoveries/{funds_recovery_id}/cancel`
- Auth: none declared

Cancel funds recovery 

Statuses that allow cancellation:

  | Status | Can Cancel? | Note |
  |--------|-------------|------|
  | `CREATED` | Yes | Before any processing |
  | `TRACKED` | Yes | After graph creation |
  | `AWAITING_ANALYSIS` | Yes | During analysis period (7 days) |
  | `ANALYSED` | Yes | After analysis completed, before refund |
  | `REFUNDING` | No | Refunds already started - irreversible process |
  | `COMPLETED` | No | Process already finished |

When a recovery is cancelled:
  * Status changes to `CANCELLED`
  * All linked infraction notifications are automatically cancelled
  * Receiver PSPs must unblock the resources that were blocked
  * Tracking graph remains available for audit
  * Process cannot be undone (but new recovery can be created)

Thie endpoint generates a [Pix funds recovery status changed](https://developers.pismo.io/events/docs/pix-dict-funds-recoveries-status-change-1) event.

## Path parameters

- `funds_recovery_id` string, required

## Response `200`

OK - synchronous success

- CancelFundsRecoveryResponse: Initiate funds recovery response
  - `id` string: Funds recovery identifier. Returned from the [Create funds recovery](https://developers.pismo.io/pismo-docs/reference/post-create-funds-recovery) endpoint.
  - `status` 'CREATED' | 'AWAITING_ANALYSIS' | 'TRACKED' | 'ANALYSED' | 'REFUNDING' | 'COMPLETED' | 'CANCELLED': Funds recovery status: * `CREATED` - For `INTERACTIVE` * `AWAITING_ANALYSIS` - For `AUTOMATED` when processed synchronously * `CREATED` - Recovery created, awaiting next action. Both flows. * `TRACKED` - Tracking graph created. `INTERACTIVE` only * `AWAITING_ANALYSIS` - Awaiting analysis from receiver PSPs (deadline: 7 days). Both flows. * `ANALYSED` - Analysis completed, ready for refund. Both flows * `REFUNDING` - Refund process in progress. Both flows. * `COMPLETED` - Recovery successfully completed. Both flows. * `CANCELLED` - Recovery cancelled. Both flows.
  - `updated_at` string, date-time: Updated datetime. A RFC 3339 date-time value. For example - `2023-04-12T23:20:50.52Z`.

## Other responses

- `202`: Ok - Asynchronous success
- `400`: Invalid funds recovery ID
- `404`: Not found
- `409`: Not allowed
- `504`: Timeout

---

[API](https://skmtc.dev/pismo/apis/platform-authentication.md) - [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/platform-authentication/revisions/935b62e16de4?raw)