Catalogs and models

CatalogsListGet

The list of available OEM catalogs (brands). Free method.

GET https://api.levam.net/oem/v1/CatalogsListGet

Parameters

Parameter	Required	Description
`api_key`	yes	API key
`type`	no	Vehicle type: empty — all, `0` — cars, `1` — commercial, `2` — motorbikes, `3` — trucks, `4` — special vehicles

Example

curl "https://api.levam.net/oem/v1/CatalogsListGet?api_key=KEY&type="

{
  "catalogs": [
    {
      "name": "Audi",
      "code": "3",
      "catalog_code": "3",
      "logo": "https://img.levam.net/images/logos/big/audi.png",
      "logo_small": "https://img.levam.net/images/logos/small/audi.png",
      "supportframesearch": "no",
      "frameexample": "",
      "supportvinsearch": "yes",
      "vinexample": "WAUBA24B3XN104537",
      "universal_classifier": "yes",
      "type_moto": "no",
      "type_auto": "yes",
      "type_transport": "no"
    }
  ],
  "error": ""
}

Response fields

Field	Description
`catalogs[].name`	Catalog name
`catalogs[].catalog_code`	Catalog code — used in other methods
`catalogs[].code`	Deprecated duplicate of `catalog_code` (kept for compatibility)
`catalogs[].logo`, `logo_small`	Catalog logos, 100×100 and 50×50
`catalogs[].supportvinsearch`, `vinexample`	VIN search support and a sample VIN for the catalog
`catalogs[].supportframesearch`, `frameexample`	FRAME search support and a sample number
`catalogs[].universal_classifier`	Whether the universal classifier is available (yes/no)
`catalogs[].type_moto`, `type_auto`, `type_transport`	Availability of motorbikes / cars / trucks and commercial vehicles
`error`	Error information; an empty string means no error

ModelsListGet2

All families and models of a single manufacturer. Free method.

GET https://api.levam.net/oem/v1/ModelsListGet2

Parameters

Parameter	Required	Description
`api_key`	yes	API key
`catalog_code`	yes	Catalog code from `CatalogsListGet`
`lang`	no	Response language
`type`	no	Vehicle type (see `CatalogsListGet`)

Example

curl "https://api.levam.net/oem/v1/ModelsListGet2?api_key=KEY&catalog_code=3"

{
  "error": "",
  "catalog": {
    "name": "Audi",
    "catalog_code": "3",
    "logo": "https://img.levam.net/images/logos/big/audi.png"
  },
  "families": {
    "Audi 100": {
      "family_name": "Audi 100",
      "family_image": "https://img.levam.net/images/oem/models/Audi_100_Mk4_C4_sedan_1991.png",
      "models": [
        { "model": "A10", "model_picture": "https://img.levam.net/images/oem/models/Audi_100_Mk4_C4_sedan_1991.png" },
        { "model": "A10C", "model_picture": "https://img.levam.net/images/oem/models/Audi_100_Mk4_C4_sedan_1991.png" }
      ]
    }
  }
}

Response fields

Field	Description
`catalog`	The selected catalog object (fields as in `CatalogsListGet`)
`families`	"Family name → family" object: `family_name`, `family_image`, `models[]`
`families.*.models[].model`	Model code — passed to `VehicleParamsSet`
`families.*.models[].model_picture`	Model image
`error`	Error information; an empty string means no error

Next: vehicle selection by parameters.