Grails API Documentation

DELETE /api/v1/listings/:id

Cancel an active listing. Sets the listing status to cancelled. Only the original seller can cancel their listing. Triggers club floor price recalculation.

Authentication: Required

Cache: None

Path Parameters

Parameter	Type	Required	Description
`id`	number	Yes	Listing ID

Sample Request


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

Response


// 200 OK
{
  "success": true,
  "data": {
    "message": "Listing cancelled successfully",
    "listing": {
      "id": 42,
      "ens_name_id": 1,
      "seller_address": "0xabcd...",
      "price_wei": "100000000000000000",
      "currency_address": "0x0000000000000000000000000000000000000000",
      "order_hash": "0x1234...",
      "order_data": { ... },
      "status": "cancelled",
      "source": "grails",
      "created_at": "2026-04-01T00:00:00.000Z",
      "updated_at": "2026-04-07T12:10:00.000Z",
      "expires_at": null,
      "broker_address": null,
      "broker_fee_bps": null
    }
  },
  "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`	Only the listing seller can cancel
404	`LISTING_NOT_FOUND`	Active listing not found