Grails API Documentation

DELETE /api/v1/orders/:id

Cancel an active order by its database ID or order hash. Only the original seller can cancel. Sets the listing status to cancelled.

Authentication: Required

Cache: None

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Listing ID (number) or order hash (hex string)

Sample Request


curl -X DELETE -H "Authorization: Bearer YOUR_TOKEN" \
  https://api.grails.app/api/v1/orders/42

Response


// 200 OK
{
  "success": true,
  "data": {
    "message": "Order cancelled successfully",
    "order": {
      "id": 42,
      "ens_name_id": 1,
      "seller_address": "0xabcd...",
      "price_wei": "100000000000000000",
      "currency_address": "0x0000000000000000000000000000000000000000",
      "order_hash": "0xabc123...",
      "order_data": "{...}",
      "status": "cancelled",
      "source": "grails",
      "broker_address": null,
      "broker_fee_bps": null,
      "expires_at": null,
      "created_at": "2026-04-07T12:00:00.000Z",
      "updated_at": "2026-04-07T12:10:00.000Z"
    }
  },
  "meta": {
    "timestamp": "2026-04-07T12:10:00.000Z",
    "version": "1.0.0"
  }
}

Error Responses

Status	Code	Description
401	`UNAUTHORIZED`	Missing or invalid token
403	`FORBIDDEN`	Cannot cancel another user’s order
404	`ORDER_NOT_FOUND`	Active order not found