carstat-app · Schema

search_results_response

CompanyAutomotiveDataVehicles

Properties

Name Type Description
metric string The metric used for ranking. Available metrics and their data sources: - `horsepower` — total system power (hp) for electrified vehicles; engine hp for ICE; summed motor output when no aggregate is av
order string Sort order applied
total_matching integer Total vehicles matching the filters (before limit)
showing integer Number of results returned
results array
View JSON Schema on GitHub

JSON Schema

carstat-app-search-results-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/carstat-app/json-schema/carstat-app-search-results-response-schema.json",
  "title": "search_results_response",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/carstat-app-vehicle-specifications-api-openapi.yml#/components/schemas/search_results_response",
  "type": "object",
  "properties": {
    "metric": {
      "type": "string",
      "description": "The metric used for ranking. Available metrics and their data sources:\n- `horsepower` — total system power (hp) for electrified vehicles; engine hp for ICE; summed motor output when no aggregate is available. Default order: desc.\n- `torque` — total system torque (Nm) for electrified vehicles; engine torque for ICE; summed motor output when no aggregate is available. Default order: desc.\n- `mpg` — combined US mpg from the available test cycle (combined, WLTC, EPA, CLTC, NEDC-equivalent, or NEDC); falls back to extra-urban mpg or EV MPGe. Default order: desc.\n- `acceleration` — 0–100 km/h time in seconds. Default order: asc (faster = lower).\n- `max_speed` — top speed in km/h. Default order: desc.\n- `curb_weight` — kerb weight in kg. Default order: asc (lighter = lower).\n- `cargo` — maximum trunk/boot volume in litres. Default order: desc.",
      "enum": [
        "horsepower",
        "torque",
        "mpg",
        "acceleration",
        "max_speed",
        "curb_weight",
        "cargo"
      ]
    },
    "order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "Sort order applied"
    },
    "total_matching": {
      "type": "integer",
      "description": "Total vehicles matching the filters (before limit)"
    },
    "showing": {
      "type": "integer",
      "description": "Number of results returned"
    },
    "results": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/search_result_item"
      }
    }
  },
  "required": [
    "metric",
    "order",
    "total_matching",
    "showing",
    "results"
  ],
  "$defs": {
    "search_result_item": {
      "type": "object",
      "description": "A single vehicle result from the search endpoint",
      "properties": {
        "modification_id": {
          "type": "string",
          "format": "uuid",
          "description": "Unique modification identifier"
        },
        "name": {
          "type": "string",
          "description": "Engine/powertrain configuration name"
        },
        "year_start": {
          "type": "integer",
          "description": "First model year this configuration was available"
        },
        "year_end": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Last confirmed production year; null when no final year is available"
        },
        "make": {
          "type": "string",
          "description": "Manufacturer name"
        },
        "model": {
          "type": "string",
          "description": "Model name"
        },
        "generation": {
          "type": [
            "string",
            "null"
          ],
          "description": "Vehicle generation name"
        },
        "model_year": {
          "type": "integer",
          "deprecated": true,
          "description": "Deprecated compatibility alias for year_start"
        },
        "body_type": {
          "type": [
            "string",
            "null"
          ],
          "description": "Body type(s), comma-separated when multiple (e.g. 'sedan', 'suv, crossover')"
        }
      },
      "additionalProperties": true
    }
  }
}

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/carstat-app-search-results-response"
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.