curl -X DELETE "https://www.okasie.be/api/external/v1/listings/DV-123456" \
-H "Authorization: Bearer YOUR_API_SECRET"
const response = await fetch(
"https://www.okasie.be/api/external/v1/listings/DV-123456",
{
method: "DELETE",
headers: { Authorization: `Bearer ${process.env.PARTNER_SECRET}` },
}
);
console.log(await response.json());
import os
import requests
response = requests.delete(
"https://www.okasie.be/api/external/v1/listings/DV-123456",
headers={"Authorization": f"Bearer {os.getenv('PARTNER_SECRET')}"},
)
print(response.json())
{
"data": {
"listingId": "0c52cae7-bcaa-4b37-be0d-1b78c92c5225",
"externalReference": "DV-123456",
"status": "sold"
}
}
{
"error": {
"code": "NOT_FOUND",
"message": "Listing not found for this partner"
}
}
Listings
Delete Listing
Take a listing offline when the car is sold or withdrawn
DELETE
/
api
/
external
/
v1
/
listings
/
{externalReference}
curl -X DELETE "https://www.okasie.be/api/external/v1/listings/DV-123456" \
-H "Authorization: Bearer YOUR_API_SECRET"
const response = await fetch(
"https://www.okasie.be/api/external/v1/listings/DV-123456",
{
method: "DELETE",
headers: { Authorization: `Bearer ${process.env.PARTNER_SECRET}` },
}
);
console.log(await response.json());
import os
import requests
response = requests.delete(
"https://www.okasie.be/api/external/v1/listings/DV-123456",
headers={"Authorization": f"Bearer {os.getenv('PARTNER_SECRET')}"},
)
print(response.json())
{
"data": {
"listingId": "0c52cae7-bcaa-4b37-be0d-1b78c92c5225",
"externalReference": "DV-123456",
"status": "sold"
}
}
{
"error": {
"code": "NOT_FOUND",
"message": "Listing not found for this partner"
}
}
Use this call when a car is sold or withdrawn. It is a soft delete: the listing gets status
To publish the same car again later, send it with Create/Update Listing and
No request body is needed.
sold and a sold date, and Okasie takes it offline about an hour later (60 to 75 minutes). After that its status reads inactive in List Listings (with status=all). The listing is not removed from Okasie’s database.
Requires the
write:listings scope.status: "active", using the same reference.
The call is idempotent: deleting a listing that is already sold or offline returns the same response. Each call sets the sold date to the current time.
Path parameter
string
required
The reference you used when creating the listing.
Response
HTTP 200 with the rate limit headers.string
Okasie listing UUID.
string
Your reference.
string
Always
sold.curl -X DELETE "https://www.okasie.be/api/external/v1/listings/DV-123456" \
-H "Authorization: Bearer YOUR_API_SECRET"
const response = await fetch(
"https://www.okasie.be/api/external/v1/listings/DV-123456",
{
method: "DELETE",
headers: { Authorization: `Bearer ${process.env.PARTNER_SECRET}` },
}
);
console.log(await response.json());
import os
import requests
response = requests.delete(
"https://www.okasie.be/api/external/v1/listings/DV-123456",
headers={"Authorization": f"Bearer {os.getenv('PARTNER_SECRET')}"},
)
print(response.json())
{
"data": {
"listingId": "0c52cae7-bcaa-4b37-be0d-1b78c92c5225",
"externalReference": "DV-123456",
"status": "sold"
}
}
{
"error": {
"code": "NOT_FOUND",
"message": "Listing not found for this partner"
}
}
Errors
| Status | Code | When |
|---|---|---|
| 401 | UNAUTHORIZED | Missing or unknown API key, or the key lacks write:listings |
| 429 | RATE_LIMITED | Rate limit reached; the body has retryAt |
| 400 | INVALID_REFERENCE | The path reference is empty |
| 404 | NOT_FOUND | Your key has no listing with this reference |
| 403 | PROFILE_FORBIDDEN | The listing belongs to a dealer that is no longer linked to your key |
| 500 | FETCH_FAILED / UPDATE_FAILED | Okasie could not read or update the listing; retry later |
When a dealer stops publishing on Okasie, delete its listings before Okasie removes the dealer from your key. Afterwards your key can no longer change them (
403 PROFILE_FORBIDDEN).