Skip to main content
GET
/
api
/
external
/
v1
/
listings
/
{externalReference}
/
status
curl -X GET "https://www.okasie.be/api/external/v1/listings/MY-REF-001/status" \
  -H "Authorization: Bearer YOUR_API_SECRET"

{
  "data": {
    "listingId": "0c52cae7-bcaa-4b37-be0d-1b78c92c5225",
    "externalReference": "MY-REF-001",
    "status": "active",
    "updatedAt": "2024-10-05T09:12:01Z"
  }
}

​
Get Listing Status

Check the current status of a listing by external reference.

​
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
Current status: active, pending, sold, or draft
​
data.updatedAt
string
ISO 8601 timestamp of last update
curl -X GET "https://www.okasie.be/api/external/v1/listings/MY-REF-001/status" \
  -H "Authorization: Bearer YOUR_API_SECRET"

{
  "data": {
    "listingId": "0c52cae7-bcaa-4b37-be0d-1b78c92c5225",
    "externalReference": "MY-REF-001",
    "status": "active",
    "updatedAt": "2024-10-05T09:12:01Z"
  }
}

​
Error Responses

StatusCodeDescription
401UNAUTHORIZEDInvalid or missing API key
404NOT_FOUNDListing not found for this partner
Use this endpoint for quick status checks without fetching the full listing data.