---
title: "Batch"
method: POST
path: "/vehicles/{vehicle_id}/batch"
tags: ["Vehicles"]
---

# Batch

`POST /vehicles/{vehicle_id}/batch`

__Description__ Returns a list of responses from multiple Smartcar endpoints, all combined into a single request. Note: Batch requests is a paid feature. Please contact us to upgrade your plan and obtain access.

## Request body

- Path[]

## Response `200`

A list of responses from multiple Smartcar endpoints

- BatchResponse
  - `responses` Response[]
    - `code` '200' | '500'
    - `path` string
    - `body` union
      - object
        - `latitude` number, float, required
        - `longitude` number, float, required
      - object
        - `distance` number, float
      - object
        - `range` number, float — The estimated remaining distance the car can travel (in kilometers by default or in miles using the sc-unit-system).
        - `percentRemaining` number, float — The remaining level of fuel in the tank (in percent).
        - `amountRemaining` number, float — The amount of fuel in the tank (in liters by default or in gallons (U.S.) using the sc-unit-system).
      - object
        - `frontLeft` number, float — The current air pressure of the front left tire (in kilopascals by default or in pounds per square inch using the sc-unit-system).
        - `frontRight` number, float — The current air pressure of the front right tire (in kilopascals by default or in pounds per square inch using the sc-unit-system).
        - `backLeft` number, float — The current air pressure of the back left tire (in kilopascals by default or in pounds per square inch using the sc-unit-system).
        - `backRight` number, float — The current air pressure of the back right tire (in kilopascals by default or in pounds per square inch using the sc-unit-system).
      - object
        - `lifeRemaining` number, float — The engine oil’s remaining life span (as a percentage). Oil life is based on the current quality of the oil. (in percent).
      - object
        - `isPluggedIn` boolean — Indicates whether a charging cable is currently plugged into the vehicle’s charge port.
        - `state` 'CHARGING' | 'FULLY_CHARGED' | 'NOT_CHARGING'
      - object
        - `limit` number, float — The level at which the vehicle should stop charging and be considered fully charged (in percent).
      - object
        - `time` string, date-time — The date and time the vehicle expects to complete this charging session.
      - object
        - `voltage` number, float — The voltage of the charger measured by the vehicle.
      - object
        - `percentRemaining` number, float — An EV battery’s state of charge (in percent).
        - `range` number, float — The estimated remaining distance the vehicle can travel (in kilometers by default or in miles using the sc-unit-system).
      - object
        - `capacity` number, float — The total capacity of the vehicle's battery (in kilowatt-hours).
      - object
        - `compatible` boolean
        - `reason` string, nullable
        - `capabilities` Capability[]
          - `permission` string
          - `endpoint` string
          - `capable` boolean
          - `reason` string, nullable
      - object — A vehicle’s manufacturer identifier.
        - `vin` string
      - object — A user ID (UUID v4).
        - `id` string
      - object
        - `status` 'SUCCESS' | 'FAILED'
        - `message` string, nullable
    - `headers` Header[]
      - `sc-unit-system` string
      - `sc-data-age` string

---

[API](https://skmtc.net/smartcar/apis/smartcar-api.md) · [All operations](https://skmtc.net/smartcar/apis/smartcar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartcar/smartcar-api/revisions/2101455240dc/schema)