Vehicle Endpoints
Batch
Vehicle Endpoints
Batch
Returns a list of responses from multiple Smartcar GET endpoints, all combined into a single request.
POST
/v2.0/vehicles/{id}/batch
Each endpoint in the batch counts against your request limit for a vehicle.
Request
Path
idrequired
string
The vehicle id of the vehicle you are making a request to.
Body
requestsrequired
array
An array of requests to make.
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.
headers
object
The headers for this response.
code
number
The HTTP resonse 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 according endpoint specification.
{
"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"
}
}
]
}
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" }]}'
{
"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"
}
}
]
}