---
updatedAt: 2026-06-11T11:59:29.000Z
agentTools:
  projectIndex: https://developer.coingate.com/llms.txt
---

# Cancel Conversion

Cancel a pending ledger currency conversion before it’s confirmed or executed. This releases any reserved amounts and marks the conversion as canceled.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "v2",
    "version": "2"
  },
  "servers": [
    {
      "url": "https://api.coingate.com/api/v2"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/ledger/conversions/{id}/cancel": {
      "patch": {
        "summary": "Cancel Conversion",
        "description": "",
        "operationId": "cancel-conversion",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Conversion ID",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"id\": \"01JWDK7X1CCB0NATRJQMMM7995\",\n  \"status\": \"canceled\",\n  \"base_amount\": \"0.001\",\n  \"base_ledger_account\": {\n    \"id\": \"01JRFQJ16HTQTT969F3G81F185\",\n    \"balance\": \"0.93433066\",\n    \"status\": \"active\",\n    \"currency\": {\n      \"id\": 1,\n      \"title\": \"Bitcoin\",\n      \"kind\": \"crypto\",\n      \"symbol\": \"BTC\",\n      \"enabled\": true,\n      \"disabled_message\": null\n    }\n  },\n  \"quote_amount\": \"81.67\",\n  \"quote_ledger_account\": {\n    \"id\": \"01JS1EHJDFEF9KD5J9FFV2A1S0\",\n    \"balance\": \"1468.8\",\n    \"status\": \"active\",\n    \"currency\": {\n      \"id\": 2,\n      \"title\": \"Euro\",\n      \"kind\": \"fiat\",\n      \"symbol\": \"EUR\",\n      \"enabled\": true,\n      \"disabled_message\": null\n    }\n  },\n  \"fees\": {\n    \"conversion_fee\": {\n      \"amount\": \"0.00001\",\n      \"currency\": {\n        \"id\": 1,\n        \"title\": \"Bitcoin\",\n        \"kind\": \"crypto\",\n        \"symbol\": \"BTC\",\n        \"enabled\": true,\n        \"disabled_message\": null\n      }\n    }\n  },\n  \"created_at\": \"2025-05-29T08:41:19.159Z\",\n  \"expires_at\": \"2025-05-29T08:42:24.149Z\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "example": "01JWDK7X1CCB0NATRJQMMM7995"
                    },
                    "status": {
                      "type": "string",
                      "example": "canceled"
                    },
                    "base_amount": {
                      "type": "string",
                      "example": "0.001"
                    },
                    "base_ledger_account": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "01JRFQJ16HTQTT969F3G81F185"
                        },
                        "balance": {
                          "type": "string",
                          "example": "0.93433066"
                        },
                        "status": {
                          "type": "string",
                          "example": "active"
                        },
                        "currency": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "integer",
                              "example": 1,
                              "default": 0
                            },
                            "title": {
                              "type": "string",
                              "example": "Bitcoin"
                            },
                            "kind": {
                              "type": "string",
                              "example": "crypto"
                            },
                            "symbol": {
                              "type": "string",
                              "example": "BTC"
                            },
                            "enabled": {
                              "type": "boolean",
                              "example": true,
                              "default": true
                            },
                            "disabled_message": {}
                          }
                        }
                      }
                    },
                    "quote_amount": {
                      "type": "string",
                      "example": "81.67"
                    },
                    "quote_ledger_account": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "01JS1EHJDFEF9KD5J9FFV2A1S0"
                        },
                        "balance": {
                          "type": "string",
                          "example": "1468.8"
                        },
                        "status": {
                          "type": "string",
                          "example": "active"
                        },
                        "currency": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "integer",
                              "example": 2,
                              "default": 0
                            },
                            "title": {
                              "type": "string",
                              "example": "Euro"
                            },
                            "kind": {
                              "type": "string",
                              "example": "fiat"
                            },
                            "symbol": {
                              "type": "string",
                              "example": "EUR"
                            },
                            "enabled": {
                              "type": "boolean",
                              "example": true,
                              "default": true
                            },
                            "disabled_message": {}
                          }
                        }
                      }
                    },
                    "fees": {
                      "type": "object",
                      "properties": {
                        "conversion_fee": {
                          "type": "object",
                          "properties": {
                            "amount": {
                              "type": "string",
                              "example": "0.00001"
                            },
                            "currency": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "integer",
                                  "example": 1,
                                  "default": 0
                                },
                                "title": {
                                  "type": "string",
                                  "example": "Bitcoin"
                                },
                                "kind": {
                                  "type": "string",
                                  "example": "crypto"
                                },
                                "symbol": {
                                  "type": "string",
                                  "example": "BTC"
                                },
                                "enabled": {
                                  "type": "boolean",
                                  "example": true,
                                  "default": true
                                },
                                "disabled_message": {}
                              }
                            }
                          }
                        }
                      }
                    },
                    "created_at": {
                      "type": "string",
                      "example": "2025-05-29T08:41:19.159Z"
                    },
                    "expires_at": {
                      "type": "string",
                      "example": "2025-05-29T08:42:24.149Z"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "404",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"message\": \"Ledger conversion not found\",\n  \"reason\": \"LedgerConversionNotFound\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "Ledger conversion not found"
                    },
                    "reason": {
                      "type": "string",
                      "example": "LedgerConversionNotFound"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "422",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"message\": \"Ledger Conversion is not valid\",\n  \"reason\": \"LedgerConversionIsNotValid\",\n  \"errors\": [\n    \"Conversion can only be canceled when in 'pending' state. Current state: completed.\"\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "Ledger Conversion is not valid"
                    },
                    "reason": {
                      "type": "string",
                      "example": "LedgerConversionIsNotValid"
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "example": "Conversion can only be canceled when in 'pending' state. Current state: completed."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```