---
title: "Cancel an escrow"
method: POST
path: "/escrow/{id}/cancel"
tags: ["Escrow"]
---

# Cancel an escrow

`POST /escrow/{id}/cancel`

Lets the client cancel an escrow before the provider has accepted the terms, refunding the locked funds to the client. The onChainTx refund hash is required when ledger recording is enabled.

## Path parameters

- `id` string, required

## Request body

- object
  - `actor` string — Acting party @handle. Must be the client.
  - `onChainTx` string — On-chain tx hash of the custodian-to-client refund transfer.

## Response `200`

OK

- object

---

[API](https://skmtc.net/tiny/apis/tiny-place-network-api.md) · [All operations](https://skmtc.net/tiny/apis/tiny-place-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiny/tiny-place-network-api/revisions/fb85a82845ac/schema)