api-ninjas-com · Schema

Car

CompanyDataFinanceDevelopers

Properties

Name Type Description
id string Handle for this exact car, e.g. car_e71ff3416a. Pass back as ?id= to re-fetch it. Safe to store: it is derived from the car's identity and survives data refreshes.
make string Manufacturer name, e.g. BMW.
model string Model name, e.g. 3 Series.
generation stringnull Generation this car belongs to, e.g. E90/E91/E92/E93. Names the whole code family, because a code cannot be mapped to one body.
chassis_codes array Every chassis code the car's generation covers, e.g. [E90, E91, E92, E93]. A property of the generation: the source does not map a code to a body, so a car claims none of them individually. Empty for
year_begin integernull First production year.
year_end integernull Last production year.
body stringnull One of Sedan, Coupe, Convertible, Wagon, Hatchback, Liftback, SUV, MPV, Van, Pickup.
doors integernull Number of doors, where known.
body_name stringnull Manufacturer's own name for the body, e.g. Touring, Avant.
trim_line stringnull Performance or equipment line, e.g. AMG, GTI.
market stringnull Regional variant, where the car is market-specific.
name string Full name as published, e.g. 320d AT (177 hp).
badge stringnull Model designation on its own, e.g. 320d. Not unique within a generation.
edition stringnull Marketing edition, e.g. EfficientDynamics Edition.
engine stringnull Short engine summary, e.g. 2.0 turbo diesel.
power_hp integernull Engine power in horsepower.
power_kw integernull Engine power in kilowatts.
displacement_l numbernull Engine displacement in litres.
cylinders integernull Number of cylinders.
transmission stringnull One of manual, automatic, cvt, dual_clutch, automated_manual, single_speed.
gearbox stringnull Manufacturer's name for the gearbox, e.g. Steptronic.
gears integernull Number of gears.
drive stringnull One of fwd, rwd, awd, 4wd.
fuel stringnull One of gasoline, diesel, electric, hybrid, plugin_hybrid, lpg, cng, hydrogen, ethanol.
engine_code stringnull Manufacturer engine code, e.g. OM646.962.
spec_count integernull Number of specification fields present in specs.
specs object Full specification sheet, always present. Values keep their unit as a separate field, e.g. {"value": 1995, "unit": "cm3"}.
View JSON Schema on GitHub

JSON Schema

api-ninjas-com-car-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/api-ninjas-com/json-schema/api-ninjas-com-car-schema.json",
  "title": "Car",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/api-ninjas-com-cars-api-openapi.yml#/components/schemas/Car",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Handle for this exact car, e.g. car_e71ff3416a. Pass back as ?id= to re-fetch it. Safe to store: it is derived from the car's identity and survives data refreshes."
    },
    "make": {
      "type": "string",
      "description": "Manufacturer name, e.g. BMW."
    },
    "model": {
      "type": "string",
      "description": "Model name, e.g. 3 Series."
    },
    "generation": {
      "type": [
        "string",
        "null"
      ],
      "description": "Generation this car belongs to, e.g. E90/E91/E92/E93. Names the whole code family, because a code cannot be mapped to one body."
    },
    "chassis_codes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Every chassis code the car's generation covers, e.g. [E90, E91, E92, E93]. A property of the generation: the source does not map a code to a body, so a car claims none of them individually. Empty for generations with no published code."
    },
    "year_begin": {
      "type": [
        "integer",
        "null"
      ],
      "description": "First production year."
    },
    "year_end": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Last production year."
    },
    "body": {
      "type": [
        "string",
        "null"
      ],
      "description": "One of Sedan, Coupe, Convertible, Wagon, Hatchback, Liftback, SUV, MPV, Van, Pickup."
    },
    "doors": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of doors, where known."
    },
    "body_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Manufacturer's own name for the body, e.g. Touring, Avant."
    },
    "trim_line": {
      "type": [
        "string",
        "null"
      ],
      "description": "Performance or equipment line, e.g. AMG, GTI."
    },
    "market": {
      "type": [
        "string",
        "null"
      ],
      "description": "Regional variant, where the car is market-specific."
    },
    "name": {
      "type": "string",
      "description": "Full name as published, e.g. 320d AT (177 hp)."
    },
    "badge": {
      "type": [
        "string",
        "null"
      ],
      "description": "Model designation on its own, e.g. 320d. Not unique within a generation."
    },
    "edition": {
      "type": [
        "string",
        "null"
      ],
      "description": "Marketing edition, e.g. EfficientDynamics Edition."
    },
    "engine": {
      "type": [
        "string",
        "null"
      ],
      "description": "Short engine summary, e.g. 2.0 turbo diesel."
    },
    "power_hp": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Engine power in horsepower."
    },
    "power_kw": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Engine power in kilowatts."
    },
    "displacement_l": {
      "type": [
        "number",
        "null"
      ],
      "description": "Engine displacement in litres."
    },
    "cylinders": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of cylinders."
    },
    "transmission": {
      "type": [
        "string",
        "null"
      ],
      "description": "One of manual, automatic, cvt, dual_clutch, automated_manual, single_speed."
    },
    "gearbox": {
      "type": [
        "string",
        "null"
      ],
      "description": "Manufacturer's name for the gearbox, e.g. Steptronic."
    },
    "gears": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of gears."
    },
    "drive": {
      "type": [
        "string",
        "null"
      ],
      "description": "One of fwd, rwd, awd, 4wd."
    },
    "fuel": {
      "type": [
        "string",
        "null"
      ],
      "description": "One of gasoline, diesel, electric, hybrid, plugin_hybrid, lpg, cng, hydrogen, ethanol."
    },
    "engine_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "Manufacturer engine code, e.g. OM646.962."
    },
    "spec_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Number of specification fields present in specs."
    },
    "specs": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "value": {
            "description": "Numeric where the source value is a clean number, otherwise the original text."
          },
          "unit": {
            "type": "string",
            "description": "Unit of measurement, where the source records one."
          }
        }
      },
      "description": "Full specification sheet, always present. Values keep their unit as a separate field, e.g. {\"value\": 1995, \"unit\": \"cm3\"}."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/api-ninjas-com-car"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.