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",
      "carPassUrl": "https://public.car-pass.be/vhr/example",
      "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"
    }
  }
}

GET

api

external

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",
      "carPassUrl": "https://public.car-pass.be/vhr/example",
      "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.

integer

default:"1"

Page number (1-based). Alias: page_number

integer

default:"50"

Number of items per page (max 200). Aliases: page_size, limit

string

default:"active"

Filter by listing status: active, pending, sold, draft, or all

string

ISO 8601 datetime for incremental sync (e.g., 2024-10-01T00:00:00Z). Alias: updated_since

string

Filter by specific dealer profile UUID

string

Alias for filtering by a specific dealer/location profile UUID

string

Alias for filtering by a specific dealer/location profile UUID. Alias: userId

string

Filter by parent dealer (includes all child locations). Aliases: parentId, companyId

string

Filter by location code (case-insensitive). Alias: location_code

Response

Listing Response Field Names

Field	Description
`id`	Okasie listing UUID
`slug`	Public Okasie listing slug
`listingUrl`	Public Okasie listing URL
`dealerProfileId`	Dealer profile UUID
`externalReference`	Partner listing reference
`externalProvider`	Partner/provider identifier
`title`	Listing title
`description`	Listing description
`status`	`active`, `pending`, `sold`, or `draft`
`price`	Listing price
`currency`	Currency, currently `EUR`
`brand`	Vehicle brand
`model`	Vehicle model
`year`	Build year
`mileage`	Mileage in kilometers
`fuelType`	Fuel type
`transmission`	Transmission type
`bodyType`	Body type
`color`	Exterior color
`doors`	Number of doors
`seats`	Number of seats
`powerKw`	Engine power in kW
`co2Emission`	CO2 emissions in g/km
`emissionClass`	Euro emission class
`firstRegistration`	First registration date
`driveType`	Drive type
`gears`	Number of gears
`interiorColor`	Interior color
`interiorMaterial`	Interior material
`weight`	Vehicle weight in kg
`previousOwners`	Number of previous owners
`serviceHistory`	Whether service history is available
`warranty`	Whether warranty is included
`warrantyMonths`	Warranty duration in months
`co2Type`	CO2 measurement standard
`paintType`	Paint type
`fuelConsumption`	Fuel consumption in L/100km
`variant`	Model variant or trim
`vehicleType`	VAT regime
`conditionTags`	Vehicle condition tags
`engine`	Engine description
`vin`	Vehicle identification number
`carPassUrl`	Public Car-Pass URL or legacy 11-digit certificate number
`location.postalCode`	Listing postal code
`location.city`	Listing city
`location.province`	Listing province
`location.latitude`	Listing latitude
`location.longitude`	Listing longitude
`images[].url`	Image URL
`images[].position`	Image order
`mainImageUrl`	First image URL
`features[].category`	Feature category
`features[].name`	Feature name
`dealer.id`	Dealer profile UUID
`dealer.parentId`	Parent dealer profile UUID
`dealer.locationCode`	Dealer location code
`dealer.companyName`	Dealer company name
`dealer.fullName`	Dealer full name
`dealer.displayName`	Dealer display name
`dealer.email`	Dealer email
`dealer.phone`	Dealer phone
`dealer.address`	Dealer address
`dealer.postalCode`	Dealer postal code
`dealer.city`	Dealer city
`dealer.province`	Dealer province
`dealer.logoUrl`	Dealer logo URL
`dealer.metadata`	Dealer location metadata
`dealer.parent`	Parent dealer summary
`createdAt`	ISO 8601 creation timestamp
`updatedAt`	ISO 8601 last update timestamp
`soldAt`	ISO 8601 sold timestamp, when sold

array

Array of listing objects

Show Listing object properties

string

Okasie listing UUID

string

Public Okasie listing slug

string

Public Okasie listing URL

string

Dealer profile UUID

string

Your unique reference

string

Partner/provider identifier

string

Listing title

string

active, pending, sold, or draft

number

Price in currency

string

ISO 4217 currency code (default: EUR)

string

Vehicle brand

string

Vehicle model

integer

Build year

integer

Kilometers

string

Public Car-Pass URL or legacy 11-digit certificate number, when provided

object

Location details with postalCode, city, province, latitude, longitude

array

Array of image objects with url and position

string

First image URL

array

Array of feature objects with category and name

object

Dealer information

string

ISO 8601 creation timestamp

string

ISO 8601 last update timestamp

object

Pagination metadata

Show Pagination properties

integer

Current page number

integer

Items per page

integer

Total number of items

integer

Total number of pages

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",
      "carPassUrl": "https://public.car-pass.be/vhr/example",
      "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"
    }
  }
}

Overview

Listings

Locations

List Listings

List Listings

Response

Listing Response Field Names

​List Listings

​Response

​Listing Response Field Names

List Listings

Response

Listing Response Field Names