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"
  }
}

DELETE

api

external

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

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"
  }
}

Status	Code	Description
400	`INVALID_REFERENCE`	External reference is required
401	`UNAUTHORIZED`	Invalid or missing API key
403	`PROFILE_FORBIDDEN`	No access to this listing
404	`NOT_FOUND`	Listing not found for this partner

This operation is idempotent. Calling DELETE on an already-sold listing will return the same response.