curl -X POST "https://www.okasie.be/api/external/v1/listings/bulk-upsert" \
  -H "Authorization: Bearer YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "externalReference": "DEX-0001",
        "dealerProfileId": "84118503-030b-45f3-a867-c77d54d00b4c",
        "status": "active",
        "title": "Jeep Compass 2019",
        "price": 18500,
        "brand": "Jeep",
        "model": "Compass",
        "year": 2019,
        "mileage": 43700,
        "fuelType": "petrol",
        "carPassUrl": "https://public.car-pass.be/vhr/example",
        "postalCode": "9000",
        "city": "Gent",
        "province": "Oost-Vlaanderen"
      },
      {
        "externalReference": "DEX-0002",
        "dealerLocationCode": "DEX-GENT",
        "status": "pending",
        "title": "Renault Trafic",
        "price": 26990,
        "brand": "Renault",
        "model": "Trafic",
        "year": 2020,
        "mileage": 65000,
        "fuelType": "diesel",
        "carPassUrl": "12345678901",
        "postalCode": "9000",
        "city": "Gent",
        "province": "Oost-Vlaanderen",
        "images": ["https://partner.example/trafic.jpg"]
      }
    ]
  }'

{
  "data": {
    "successCount": 2,
    "errorCount": 0,
    "results": [
      {
        "index": 0,
        "externalReference": "DEX-0001",
        "listingId": "0c52cae7-bcaa-4b37-be0d-1b78c92c5225",
        "status": "active",
        "created": true
      },
      {
        "index": 1,
        "externalReference": "DEX-0002",
        "listingId": "1d63dbf8-cdbb-5c48-cf1e-2c89d93d6336",
        "status": "pending",
        "created": true
      }
    ],
    "errors": []
  }
}

POST

api

external

listings

bulk-upsert

curl -X POST "https://www.okasie.be/api/external/v1/listings/bulk-upsert" \
  -H "Authorization: Bearer YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "externalReference": "DEX-0001",
        "dealerProfileId": "84118503-030b-45f3-a867-c77d54d00b4c",
        "status": "active",
        "title": "Jeep Compass 2019",
        "price": 18500,
        "brand": "Jeep",
        "model": "Compass",
        "year": 2019,
        "mileage": 43700,
        "fuelType": "petrol",
        "carPassUrl": "https://public.car-pass.be/vhr/example",
        "postalCode": "9000",
        "city": "Gent",
        "province": "Oost-Vlaanderen"
      },
      {
        "externalReference": "DEX-0002",
        "dealerLocationCode": "DEX-GENT",
        "status": "pending",
        "title": "Renault Trafic",
        "price": 26990,
        "brand": "Renault",
        "model": "Trafic",
        "year": 2020,
        "mileage": 65000,
        "fuelType": "diesel",
        "carPassUrl": "12345678901",
        "postalCode": "9000",
        "city": "Gent",
        "province": "Oost-Vlaanderen",
        "images": ["https://partner.example/trafic.jpg"]
      }
    ]
  }'

{
  "data": {
    "successCount": 2,
    "errorCount": 0,
    "results": [
      {
        "index": 0,
        "externalReference": "DEX-0001",
        "listingId": "0c52cae7-bcaa-4b37-be0d-1b78c92c5225",
        "status": "active",
        "created": true
      },
      {
        "index": 1,
        "externalReference": "DEX-0002",
        "listingId": "1d63dbf8-cdbb-5c48-cf1e-2c89d93d6336",
        "status": "pending",
        "created": true
      }
    ],
    "errors": []
  }
}

Bulk Create/Update Listings

Upsert up to 100 listings in a single request. Each item is processed independently, allowing partial success.

Requires the write:listings scope. Contact support to enable write access.

Request Body

The request body can be either:

An array of listing objects
An object with an items property containing the array

Each item must include externalReference (or the accepted alias external_reference) plus all required listing fields.

All JSON field names, including Car-Pass/carpass aliases like carPassNumber, are listed in the single upsert field reference.

items

array

required

Array of listing objects (max 100 items)

Show Item properties

externalReference

string

required

Your unique reference for this listing

external_reference

string

Accepted alias for externalReference; prefer externalReference

dealerProfileId

string

Dealer profile UUID

dealerLocationCode

string

Location code

status

string

active, pending, sold, or draft

title

string

required

Listing title

price

number

Price (required for active/pending)

carPassUrl

string

Public Car-Pass URL from public.car-pass.be or car-pass.be, or a legacy 11-digit certificate number. Input aliases carPass, car_pass_url, and carPassNumber are also accepted.

...

All other fields from the single upsert endpoint

Response

data.successCount

integer

Number of successfully processed items

data.errorCount

integer

Number of failed items

data.results

array

Array of successful results

Show Result properties

index

integer

Position in the input array

externalReference

string

Your reference

listingId

string

Okasie listing UUID

status

string

Listing status

created

boolean

True if newly created

data.errors

array

Array of failed items with error details

Show Error properties

index

integer

Position in the input array

externalReference

string

Your reference (if provided)

code

string

Error code

message

string

Error message

status

integer

HTTP status code for this error

curl -X POST "https://www.okasie.be/api/external/v1/listings/bulk-upsert" \
  -H "Authorization: Bearer YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "externalReference": "DEX-0001",
        "dealerProfileId": "84118503-030b-45f3-a867-c77d54d00b4c",
        "status": "active",
        "title": "Jeep Compass 2019",
        "price": 18500,
        "brand": "Jeep",
        "model": "Compass",
        "year": 2019,
        "mileage": 43700,
        "fuelType": "petrol",
        "carPassUrl": "https://public.car-pass.be/vhr/example",
        "postalCode": "9000",
        "city": "Gent",
        "province": "Oost-Vlaanderen"
      },
      {
        "externalReference": "DEX-0002",
        "dealerLocationCode": "DEX-GENT",
        "status": "pending",
        "title": "Renault Trafic",
        "price": 26990,
        "brand": "Renault",
        "model": "Trafic",
        "year": 2020,
        "mileage": 65000,
        "fuelType": "diesel",
        "carPassUrl": "12345678901",
        "postalCode": "9000",
        "city": "Gent",
        "province": "Oost-Vlaanderen",
        "images": ["https://partner.example/trafic.jpg"]
      }
    ]
  }'

{
  "data": {
    "successCount": 2,
    "errorCount": 0,
    "results": [
      {
        "index": 0,
        "externalReference": "DEX-0001",
        "listingId": "0c52cae7-bcaa-4b37-be0d-1b78c92c5225",
        "status": "active",
        "created": true
      },
      {
        "index": 1,
        "externalReference": "DEX-0002",
        "listingId": "1d63dbf8-cdbb-5c48-cf1e-2c89d93d6336",
        "status": "pending",
        "created": true
      }
    ],
    "errors": []
  }
}

Error Responses

Status	Code	Description
400	`EMPTY_PAYLOAD`	No items provided
400	`TOO_MANY_ITEMS`	More than 100 items
400	`INVALID_JSON`	Invalid JSON body

For large imports, split your data into batches of 100 items and process them sequentially with a small delay between batches.

Create/Update Listing Mark Listing as Sold

​Bulk Create/Update Listings

​Request Body

​Response

​Error Responses

Bulk Create/Update Listings

Request Body

Response

Error Responses