Skip to main content
DELETE
/
api
/
external
/
v1
/
listings
/
{externalReference}
curl -X DELETE "https://www.okasie.be/api/external/v1/listings/MY-REF-001" \
  -H "Authorization: Bearer YOUR_API_SECRET"
{
  "data": {
    "listingId": "0c52cae7-bcaa-4b37-be0d-1b78c92c5225",
    "externalReference": "MY-REF-001",
    "status": "sold"
  }
}

Mark Listing as Sold

Mark a listing as sold by external reference. This is a soft delete - the listing remains in the system with status sold.
Requires the write:listings scope. Contact support to enable write access.

Path Parameters

externalReference
string
required
Your unique reference for this listing

Response

data.listingId
string
Okasie listing UUID
data.externalReference
string
Your provided reference
data.status
string
Always sold
curl -X DELETE "https://www.okasie.be/api/external/v1/listings/MY-REF-001" \
  -H "Authorization: Bearer YOUR_API_SECRET"
{
  "data": {
    "listingId": "0c52cae7-bcaa-4b37-be0d-1b78c92c5225",
    "externalReference": "MY-REF-001",
    "status": "sold"
  }
}

Error Responses

StatusCodeDescription
400INVALID_REFERENCEExternal reference is required
401UNAUTHORIZEDInvalid or missing API key
403PROFILE_FORBIDDENNo access to this listing
404NOT_FOUNDListing not found for this partner
This operation is idempotent. Calling DELETE on an already-sold listing will return the same response.