---
agentTools:
  projectIndex: https://developers.matchbook.com/llms.txt
---

# Cancel Offers

Cancel some or all of your open offers.

API GROUP : BETTING_WRITE

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "API Settings",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.matchbook.com"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/edge/rest/v2/offers": {
      "delete": {
        "summary": "Cancel Offers",
        "description": "Cancel some or all of your open offers.\n\nAPI GROUP : BETTING_WRITE",
        "operationId": "cancel-offers-v2",
        "parameters": [
          {
            "name": "event-ids",
            "in": "query",
            "description": "A comma separated list of event ids. Only offers on the provided events are cancelled.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "market-ids",
            "in": "query",
            "description": "A comma separated list of market ids. Only offers on the provided markets are cancelled.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "runner-ids",
            "in": "query",
            "description": "A comma separated list of runner ids. Only offers on the provided runners are cancelled.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offer-ids",
            "in": "query",
            "description": "A comma separated list of offer ids. Only the specified offers are cancelled.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"language\": \"en\",\n    \"currency\": \"EUR\",\n    \"exchange-type\": \"back-lay\",\n    \"odds-type\": \"DECIMAL\",\n    \"offers\": [\n        {\n            \"id\": 413775799780013,\n            \"event-id\": 412878712890009,\n            \"event-name\": \"T Berdych vs M Klizan\",\n            \"market-id\": 412878713090010,\n            \"market-name\": \"Moneyline\",\n            \"market-type\": \"one_x_two\",\n            \"runner-id\": 412878713120009,\n            \"runner-name\": \"T Berdych\",\n            \"exchange-type\": \"back-lay\",\n            \"side\": \"back\",\n            \"odds\": 1.1,\n            \"odds-type\": \"DECIMAL\",\n            \"decimal-odds\": 1.1,\n            \"stake\": 2,\n            \"remaining\": 2,\n            \"potential-profit\": 0.2,\n            \"remaining-potential-profit\": 0.2,\n            \"commission-type\": \"VOLUME\",\n            \"originator-commission-rate\": 0,\n            \"acceptor-commission-rate\": 0,\n            \"commission-reserve\": 0,\n            \"currency\": \"EUR\",\n            \"created-at\": \"2017-02-17T12:27:31.408Z\",\n            \"status\": \"cancelled\",\n            \"in-play\": false\n        }\n    ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "language": {
                      "type": "string",
                      "example": "en"
                    },
                    "currency": {
                      "type": "string",
                      "example": "EUR"
                    },
                    "exchange-type": {
                      "type": "string",
                      "example": "back-lay"
                    },
                    "odds-type": {
                      "type": "string",
                      "example": "DECIMAL"
                    },
                    "offers": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "example": 413775799780013,
                            "default": 0
                          },
                          "event-id": {
                            "type": "integer",
                            "example": 412878712890009,
                            "default": 0
                          },
                          "event-name": {
                            "type": "string",
                            "example": "T Berdych vs M Klizan"
                          },
                          "market-id": {
                            "type": "integer",
                            "example": 412878713090010,
                            "default": 0
                          },
                          "market-name": {
                            "type": "string",
                            "example": "Moneyline"
                          },
                          "market-type": {
                            "type": "string",
                            "example": "one_x_two"
                          },
                          "runner-id": {
                            "type": "integer",
                            "example": 412878713120009,
                            "default": 0
                          },
                          "runner-name": {
                            "type": "string",
                            "example": "T Berdych"
                          },
                          "exchange-type": {
                            "type": "string",
                            "example": "back-lay"
                          },
                          "side": {
                            "type": "string",
                            "example": "back"
                          },
                          "odds": {
                            "type": "number",
                            "example": 1.1,
                            "default": 0
                          },
                          "odds-type": {
                            "type": "string",
                            "example": "DECIMAL"
                          },
                          "decimal-odds": {
                            "type": "number",
                            "example": 1.1,
                            "default": 0
                          },
                          "stake": {
                            "type": "integer",
                            "example": 2,
                            "default": 0
                          },
                          "remaining": {
                            "type": "integer",
                            "example": 2,
                            "default": 0
                          },
                          "potential-profit": {
                            "type": "number",
                            "example": 0.2,
                            "default": 0
                          },
                          "remaining-potential-profit": {
                            "type": "number",
                            "example": 0.2,
                            "default": 0
                          },
                          "commission-type": {
                            "type": "string",
                            "example": "VOLUME"
                          },
                          "originator-commission-rate": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "acceptor-commission-rate": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "commission-reserve": {
                            "type": "integer",
                            "example": 0,
                            "default": 0
                          },
                          "currency": {
                            "type": "string",
                            "example": "EUR"
                          },
                          "created-at": {
                            "type": "string",
                            "example": "2017-02-17T12:27:31.408Z"
                          },
                          "status": {
                            "type": "string",
                            "example": "cancelled"
                          },
                          "in-play": {
                            "type": "boolean",
                            "example": false,
                            "default": true
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "User-Agent",
        "value": "api-doc-test-client"
      }
    ],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "58b53d1c1065f9c438aa22fa:5bf2ba1cfce1eb00387cc6ee"
}
```