Skip to main content
GET
/
api
/
external
/
v1
/
listings
curl -X GET "https://www.okasie.be/api/external/v1/listings?pageSize=50&status=active" \
  -H "Authorization: Bearer YOUR_API_SECRET"

{
  "data": [
    {
      "id": "46c7f6c9-70f7-4f98-8c32-12f1a67c6f2e",
      "dealerProfileId": "7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f",
      "externalReference": "ref-123",
      "title": "Opel Corsa 1.2 Turbo",
      "status": "active",
      "price": 19995,
      "currency": "EUR",
      "brand": "Opel",
      "model": "Corsa",
      "year": 2021,
      "mileage": 25000,
      "fuelType": "petrol",
      "transmission": "automatic",
      "bodyType": "hatchback",
      "location": {
        "postalCode": "9000",
        "city": "Gent",
        "province": "Oost-Vlaanderen",
        "latitude": 51.0543,
        "longitude": 3.7174
      },
      "images": [
        {"url": "https://cdn.okasie.be/images/46c7f6c9/main.jpg", "position": 0}
      ],
      "dealer": {
        "id": "7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f",
        "companyName": "Auto Gent",
        "locationCode": "DEX-GENT"
      },
      "createdAt": "2024-10-01T12:34:56Z",
      "updatedAt": "2024-10-05T09:12:01Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 50,
    "totalItems": 123,
    "totalPages": 3
  },
  "meta": {
    "partner": {
      "id": "partner-id",
      "name": "Partner Name"
    }
  }
}

​
List Listings

Retrieve a paginated list of vehicle listings within your partner access scope.
​
page
integer
default:"1"
Page number (1-based)
​
pageSize
integer
default:"50"
Number of items per page (max 200)
​
status
string
default:"active"
Filter by listing status: active, pending, sold, draft, or all
​
updatedSince
string
ISO 8601 datetime for incremental sync (e.g., 2024-10-01T00:00:00Z)
​
dealerId
string
Filter by specific dealer profile UUID
​
parentDealerId
string
Filter by parent dealer (includes all child locations)
​
locationCode
string
Filter by location code (case-insensitive)

​
Response

​
data
array
Array of listing objects
​
pagination
object
Pagination metadata
​
meta
object
Request metadata including partner info and applied filters
curl -X GET "https://www.okasie.be/api/external/v1/listings?pageSize=50&status=active" \
  -H "Authorization: Bearer YOUR_API_SECRET"

{
  "data": [
    {
      "id": "46c7f6c9-70f7-4f98-8c32-12f1a67c6f2e",
      "dealerProfileId": "7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f",
      "externalReference": "ref-123",
      "title": "Opel Corsa 1.2 Turbo",
      "status": "active",
      "price": 19995,
      "currency": "EUR",
      "brand": "Opel",
      "model": "Corsa",
      "year": 2021,
      "mileage": 25000,
      "fuelType": "petrol",
      "transmission": "automatic",
      "bodyType": "hatchback",
      "location": {
        "postalCode": "9000",
        "city": "Gent",
        "province": "Oost-Vlaanderen",
        "latitude": 51.0543,
        "longitude": 3.7174
      },
      "images": [
        {"url": "https://cdn.okasie.be/images/46c7f6c9/main.jpg", "position": 0}
      ],
      "dealer": {
        "id": "7f7f7f7f-7f7f-407f-a7f7-7f7f7f7f7f7f",
        "companyName": "Auto Gent",
        "locationCode": "DEX-GENT"
      },
      "createdAt": "2024-10-01T12:34:56Z",
      "updatedAt": "2024-10-05T09:12:01Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 50,
    "totalItems": 123,
    "totalPages": 3
  },
  "meta": {
    "partner": {
      "id": "partner-id",
      "name": "Partner Name"
    }
  }
}