api-ninjas-com

api-ninjas-com Electric Vehicle API

The Electric Vehicle API provides detailed data on electric vehicles including range, battery capacity, charging time, and performance metrics.

Documentation GitHub OpenAPI

Operations 3

GET /v1/electricvehicle Get electric vehicle data by various parameters #

GET /v1/electricvehiclemakes Get a list of all electric vehicle manufacturers #

GET /v1/electricvehiclemodels Get all models for a specific manufacturer #

Work with this as data

Every API 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 apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
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 API

curl "https://apis.io/api/v1/apis/api-ninjas-com:api-ninjas-com-electric-vehicle-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Ninjas Electric Vehicle API
  description: 'Combined OpenAPI specification for every API Ninjas endpoint. Requests go to https://api.api-ninjas.com with an `X-Api-Key` header; get a free key at https://api-ninjas.com/register. Human-readable docs: https://api-ninjas.com/api. Index for LLMs: https://api-ninjas.com/llms.txt.'
  version: 1.0.0
  contact:
    name: API Ninjas
    url: https://api-ninjas.com
  license:
    name: Proprietary
servers:
- url: https://api.api-ninjas.com
  description: API Ninjas Production
security:
- ApiKeyAuth: []
tags:
- name: Electric Vehicle
  description: The Electric Vehicle API provides detailed data on electric vehicles including range, battery capacity, charging time, and performance metrics.
paths:
  /v1/electricvehicle:
    get:
      tags:
      - Electric Vehicle
      summary: Get electric vehicle data by various parameters
      description: Returns electric vehicle records with range, battery, charging, and performance data, filtered by make, model, year, or range. For maker names use /electricvehiclemakes.
      operationId: getElectricVehicleData
      parameters:
      - name: make
        in: query
        description: Vehicle manufacturer (e.g., tesla or nissan)
        required: false
        schema:
          type: string
      - name: model
        in: query
        description: Vehicle model. Supports partial matching (e.g., 'Model' matches 'Model 3', 'Model Y', etc.).
        required: false
        schema:
          type: string
      - name: min_year
        in: query
        description: Minimum vehicle model year (e.g., 2020)
        required: false
        schema:
          type: integer
      - name: max_year
        in: query
        description: Maximum vehicle model year (e.g., 2023)
        required: false
        schema:
          type: integer
      - name: min_range
        in: query
        description: Minimum range in kilometers (e.g., 250)
        required: false
        schema:
          type: integer
      - name: max_range
        in: query
        description: Maximum range in kilometers (e.g., 400)
        required: false
        schema:
          type: integer
      - name: limit
        in: query
        description: How many results to return. Must be between 1 and 10. Default is 1.
        required: false
        schema:
          type: integer
          default: 1
          minimum: 1
          maximum: 10
      - name: offset
        in: query
        description: Number of results to skip. Used for pagination. Default is 0.
        required: false
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: A list of electric vehicles
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ElectricVehicle'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectricVehicleOpenapi_Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectricVehicleOpenapi_Error'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectricVehicleOpenapi_Error'
      security:
      - ApiKeyAuth: []
  /v1/electricvehiclemakes:
    get:
      tags:
      - Electric Vehicle
      summary: Get a list of all electric vehicle manufacturers
      description: Returns the list of electric vehicle manufacturers, optionally filtered by year. For the models of one manufacturer use /electricvehiclemodels.
      operationId: getElectricVehicleMakes
      parameters:
      - name: year
        in: query
        description: Filter manufacturers by year (e.g., 2023)
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: A list of electric vehicle manufacturers
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectricVehicleOpenapi_Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectricVehicleOpenapi_Error'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectricVehicleOpenapi_Error'
      security:
      - ApiKeyAuth: []
  /v1/electricvehiclemodels:
    get:
      tags:
      - Electric Vehicle
      summary: Get all models for a specific manufacturer
      description: Returns all electric vehicle models for one manufacturer, optionally filtered by year. Requires a `make`. For full vehicle specs use /electricvehicle.
      operationId: getElectricVehicleModels
      parameters:
      - name: make
        in: query
        description: Vehicle manufacturer (e.g., tesla)
        required: true
        schema:
          type: string
      - name: year
        in: query
        description: Vehicle model year (e.g., 2023)
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: A list of electric vehicle models for the specified make
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectricVehicleOpenapi_Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectricVehicleOpenapi_Error'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ElectricVehicleOpenapi_Error'
      security:
      - ApiKeyAuth: []
components:
  schemas:
    ElectricVehicleOpenapi_Error:
      type: object
      properties:
        message:
          type: string
        status:
          type: integer
    ElectricVehicle:
      type: object
      properties:
        make:
          type: string
          example: Tesla
        model:
          type: string
          example: Model 3
        year_start:
          type: string
          example: '2023'
        battery_capacity:
          type: string
          example: 60.0 kWh
        battery_type:
          type: string
          example: Lithium-ion
        battery_number_of_cells:
          type: string
          example: '106'
        battery_architecture:
          type: string
          example: 400 V
        battery_useable_capacity:
          type: string
          description: Usable battery capacity in kWh.
          example: 57.5 kWh
        battery_cathode_material:
          type: string
          example: LFP
        battery_pack_configuration:
          type: string
          example: 106s1p
        battery_voltage:
          type: string
          example: 340 V
        battery_form_factor:
          type: string
          example: Prismatic
        battery_name:
          type: string
          example: CATL LFP60
        charge_port:
          type: string
          example: CCS
        charge_port_location:
          type: string
          example: Left Side - Rear
        charge_power:
          type: string
          example: 11 kW AC
        charge_speed:
          type: string
          example: 730 km/h
        charge_power_max:
          type: string
          description: Maximum DC fast-charging power.
          example: 170 kW DC
        charge_power_10p_80p:
          type: string
          example: 108 kW DC
        autocharge_supported:
          type: string
          example: 'Yes'
        plug_charge_supported:
          type: string
          example: 'No'
        supported_charging_protocol:
          type: string
        preconditioning_possible:
          type: string
          example: 'Yes'
        acceleration_0_100_kmh:
          type: string
          example: 6.1 sec
        top_speed:
          type: string
          description: Top speed in km/h. Premium only.
          example: 201 km/h
        electric_range:
          type: string
          example: 420 km
        total_power:
          type: string
          example: 208 kW (283 PS)
        total_torque:
          type: string
          example: 420 Nm
        drive:
          type: string
          example: Rear
        vehicle_consumption:
          type: string
          example: 112 Wh/km
        co2_emissions:
          type: string
          example: 0 g/km
        vehicle_fuel_equivalent:
          type: string
          example: 1.3 l/100km
        rated_consumption:
          type: string
        rated_fuel_equivalent:
          type: string
        energy_consumption_city_cold_weather:
          type: string
          example: 149 Wh/km
        energy_consumption_highway_cold_weather:
          type: string
          example: 189 Wh/km
        energy_consumption_combined_cold_weather:
          type: string
          example: 167 Wh/km
        energy_consumption_city_mild_weather:
          type: string
          example: 93 Wh/km
        energy_consumption_highway_mild_weather:
          type: string
          example: 142 Wh/km
        energy_consumption_combined_mild_weather:
          type: string
          example: 116 Wh/km
        length:
          type: string
          example: 4720 mm
        width:
          type: string
          example: 1849 mm
        width_with_mirrors:
          type: string
          example: 2089 mm
        height:
          type: string
          example: 1441 mm
        wheelbase:
          type: string
          example: 2875 mm
        gross_vehicle_weight:
          type: string
          example: 2200 kg
        max_payload:
          type: string
          example: 439 kg
        cargo_volume:
          type: string
          example: 594 L
        cargo_volume_frunk:
          type: string
          example: 88 L
        seats:
          type: string
          example: 5 people
        turning_circle:
          type: string
        platform:
          type: string
          example: TESLA 3/Y
        car_body:
          type: string
          example: Sedan
        segment:
          type: string
          example: D - Large
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
externalDocs:
  description: API Ninjas documentation
  url: https://api-ninjas.com/api