Skip to main content
POST
/
api
/
external
/
v1
/
listings
/
{externalReference}
/
status
curl -X POST "https://www.okasie.be/api/external/v1/listings/MY-REF-001/status" \
  -H "Authorization: Bearer YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"status": "pending"}'

{
  "data": {
    "listingId": "0c52cae7-bcaa-4b37-be0d-1b78c92c5225",
    "externalReference": "MY-REF-001",
    "status": "pending"
  }
}

​
Update Listing Status

Update the current status of a listing by external reference.
Requires the write:listings scope. Contact support to enable write access.

​
Path Parameters

​
externalReference
string
required
Your unique reference for this listing

​
Request Body

​
status
string
required
New status: active, pending, sold, or draft

​
Response

​
data.listingId
string
Okasie listing UUID
​
data.externalReference
string
Your provided reference
​
data.status
string
Updated status: active, pending, sold, or draft
curl -X POST "https://www.okasie.be/api/external/v1/listings/MY-REF-001/status" \
  -H "Authorization: Bearer YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"status": "pending"}'

{
  "data": {
    "listingId": "0c52cae7-bcaa-4b37-be0d-1b78c92c5225",
    "externalReference": "MY-REF-001",
    "status": "pending"
  }
}

​
Error Responses

StatusCodeDescription
400INVALID_REFERENCEExternal reference is required
400INVALID_JSONRequest body must be valid JSON
400INVALID_BODYRequest body must be an object
401UNAUTHORIZEDInvalid or missing API key
403PROFILE_FORBIDDENNo access to this listing
404NOT_FOUNDListing not found for this partner
422VALIDATION_FAILEDInvalid or missing status
Use this endpoint for lightweight status changes. Use DELETE when you only need to mark a listing as sold.