Batch

Returns a list of responses from multiple Smartcar GET endpoints, all combined into a single request.

cURL

curl "https://api.smartcar.com/v2.0/vehicles/{id}/batch" \
-H "Authorization: Bearer {token}" \
-X "POST" \
-H "Content-Type: application/json" \
-d '{"requests": [{ "path" : "/odometer" }, { "path" : "/location" }]}'

Example Response

{
  "responses": [
    {
      "path": "/odometer",
      "body": {
        "distance": 37829
      },
      "code": 200,
      "headers": {
        "sc-data-age": "2019-10-24T00:43:46.000Z",
        "sc-unit-system": "metric"
      }
    },
    {
      "path": "/location",
      "body": {
        "latitude": 37.4292,
        "longitude": 122.1381
      },
      "code": 200,
      "headers": {
        "sc-data-age": "2019-10-24T00:43:46.000Z"
      }
    }
  ]
}

The Vehicles API v2.0 will be deprecated by Q4 of 2026. We recommend migrating to the latest version as soon as possible to ensure continued support and access to new features.

Each endpoint in the batch counts against your request limit for a vehicle.

Request

Path

id · string · required

The vehicle ID of the vehicle you are making a request to.

Body

requests · array · required

An array of requests to make.

Show child attributes

path · string · required

The Smartcar endpoint to request data from.

cURL

curl "https://api.smartcar.com/v2.0/vehicles/{id}/batch" \
-H "Authorization: Bearer {token}" \
-X "POST" \
-H "Content-Type: application/json" \
-d '{"requests": [{ "path" : "/odometer" }, { "path" : "/location" }]}'

Response

responses · array

The responses from Smartcar.

Hide response

headers · object

The headers for this response.

Show headers

sc-unit-system · string

The unit system to use for the request.

sc-data-age · string

The timestamp (ISO-8601 format) of when the returned data was recorded by the vehicle.

code · number

The HTTP response status code.

path · string

The Smartcar endpoint to request data from.

body · string

The response body of this request. The structure of this object will vary by endpoint. See the corresponding endpoint specification.

Example Response

{
  "responses": [
    {
      "path": "/odometer",
      "body": {
        "distance": 37829
      },
      "code": 200,
      "headers": {
        "sc-data-age": "2019-10-24T00:43:46.000Z",
        "sc-unit-system": "metric"
      }
    },
    {
      "path": "/location",
      "body": {
        "latitude": 37.4292,
        "longitude": 122.1381
      },
      "code": 200,
      "headers": {
        "sc-data-age": "2019-10-24T00:43:46.000Z"
      }
    }
  ]
}