Skip to content
KasblyKasbly Docs

Canonical filter values (manufacturers, models, editions, fuel types, vehicle types, colors, interior colors) for URL builders

GET
/api/v1/cars/filter-values
curl --request GET \
  --url https://api.dokanmazad.com/api/v1/cars/filter-values \
  --header 'X-API-Key: <X-API-Key>'

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”

Success

Media typeapplication/json
object
success
required
boolean
data
required
meta
object
page
integer
limit
integer
total
integer
totalPages
integer
data
required
object
manufacturers
required

Distinct makes in the catalog (English). Pass into the makeEn filter.

Array<string>
models
required

Distinct models (English), flat — not grouped by make. Pass into the modelEn filter.

Array<string>
editions
required

Distinct editions/grades (English), flat. Pass into the gradeEn filter.

Array<string>
fuelTypes
required

Fixed canonical fuel types (matches web sidebar). Pass into the fuelType filter (matched case-insensitively).

Array<string>
vehicleTypes
required

Fixed canonical body styles (matches web sidebar). Pass into the vehicleType filter.

Array<string>
colors
required

Fixed canonical exterior colors (matches web sidebar). Pass into the color filter.

Array<string>
interiorColors
required

Fixed canonical interior colors (matches web sidebar). Pass into the interiorColor filter.

Array<string>
Examples
Examplesuccess
{
  "success": true,
  "data": {
    "manufacturers": [
      "BMW",
      "Hyundai",
      "Kia"
    ],
    "models": [
      "320i",
      "Sonata",
      "Sorento"
    ],
    "editions": [
      "320i M Sport",
      "Premium"
    ],
    "fuelTypes": [
      "Gasoline",
      "Diesel",
      "Hybrid",
      "Electric",
      "LPG"
    ],
    "vehicleTypes": [
      "Sedan",
      "SUV",
      "Hatchback/Wagon",
      "Pick Up/Truck",
      "Coupe/Sprt",
      "Van"
    ],
    "colors": [
      "White",
      "Black",
      "Gray",
      "Silver",
      "Pearl"
    ],
    "interiorColors": [
      "White",
      "Black",
      "Gray",
      "Silver",
      "Pearl"
    ]
  }
}

401

Section titled “401”

Unauthorized — missing or invalid API key

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

403

Section titled “403”

Forbidden — route not in this key’s allowedRoutes

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

429

Section titled “429”

Rate limit exceeded

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds to wait before retrying