---
updatedAt: 2025-06-06T11:34:48.000Z
agentTools:
  projectIndex: https://rootvx.readme.io/llms.txt
---

# Cancel an Escrow

This endpoint is used to cancel an existing escrow. The escrow is identified by its unique ID, and once canceled, the escrow process is terminated, preventing any further actions or deposits.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "description": "This is a api for creating and interacting with escrow apps on Rootpe",
    "title": "Escrows API",
    "contact": {
      "name": "Rootpe"
    },
    "license": {
      "name": "Apache 2.0",
      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
    },
    "version": "1.0"
  },
  "paths": {
    "/escrows/cancel": {
      "post": {
        "description": "This endpoint is used to cancel an existing escrow. The escrow is identified by its unique ID, and once canceled, the escrow process is terminated, preventing any further actions or deposits.",
        "tags": [
          "Escrow"
        ],
        "summary": "Cancel an Escrow",
        "operationId": "cancel-escrow",
        "parameters": [
          {
            "description": "The unique identifier of the escrow to be canceled.",
            "example": "692f6eca-6276-4993-bfeb-53cbbbba6f08",
            "name": "id",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/model.Escrow"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/httputil.HTTPError"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/httputil.HTTPError"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/httputil.HTTPError"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "//34.67.61.66:80"
    }
  ],
  "components": {
    "schemas": {
      "httputil.HTTPError": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "The HTTP status code indicating the type of error. For example, 400 for a bad request.",
            "example": 400
          },
          "message": {
            "type": "string",
            "description": "A brief description of the error. For instance, \"status bad request\" explains the nature of the issue.",
            "example": "status bad request"
          }
        }
      },
      "model.Escrow": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "The unique identifier of the created escrow.",
            "example": "692f6eca-6276-4993-bfeb-53cbbbba6f08"
          },
          "created_at": {
            "type": "integer",
            "format": "int64",
            "description": "The unix timestamp of when the escrow was created.",
            "example": 1749191516
          },
          "name": {
            "type": "string",
            "description": "The name assigned to the escrow.",
            "example": "Gaming Escrow"
          },
          "type": {
            "type": "string",
            "description": "The type or classification of the escrow.",
            "example": "GAMING"
          },
          "status": {
            "type": "string",
            "description": "The current status of the escrow. (e.g., FUNDING)",
            "example": "FUNDING"
          },
          "address": {
            "type": "string",
            "description": "The address associated with the escrow.",
            "example": "0x0000000000000000000000000000000000000000"
          },
          "currency_code": {
            "type": "string",
            "description": "The currency code of the ledger or token being used for the escrow.",
            "example": "INR"
          },
          "funding_end_time": {
            "type": "integer",
            "format": "int64",
            "description": "The unix timestamp for when funding ends.",
            "example": 1749195516
          },
          "dispute_end_time": {
            "type": "integer",
            "format": "int64",
            "description": "The unix timestamp for when the dispute period ends.",
            "example": 1749200000
          },
          "dispute_period": {
            "type": "integer",
            "format": "int64",
            "description": "The duration of the dispute period in seconds.",
            "example": 3600
          },
          "funding_period": {
            "type": "integer",
            "format": "int64",
            "description": "The duration of the funding period in seconds.",
            "example": 7200
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```