---
title: "getVehicles"
method: GET
path: "/catalog/2024-11-01/automotive/vehicles"
tags: ["Vehicles v2024-11-01"]
---

# getVehicles

`GET /catalog/2024-11-01/automotive/vehicles`

Get the latest collection of vehicles

## Query parameters

- `pageToken` string
- `marketplaceId` string, required
- `vehicleType` 'CAR' | 'MOTORBIKE', required
- `updatedAfter` string

## Response `200`

Success.

- VehiclesResponse — Get paginated list of vehicle from Amazon's catalog
  - `pagination` Pagination — The pagination elements required to retrieve the remaining data.
    - `nextToken` string — A generated string used to pass information to your next request. If NextToken is returned, pass the value of NextToken to the next request. If NextToken is not returned, there are no more shipment items to return.
  - `vehicles` Vehicle[], required — List of vehicles from Amazon's catalog.
    - `make` string, required — Vehicle Brand.
    - `model` string, required — Specific model of a vehicle.
    - `variantName` string — Name of the vehicle variant.
    - `bodyStyle` string — Body style of vehicle (example: Hatchback, Cabriolet).
    - `driveType` string — Drive type of vehicle(example: Rear wheel drive).
    - `energy` string — Energy Source for the vehicle(example: Petrol)
    - `engineOutput` EngineOutput[] — Engine output of vehicle.
      - `value` number, required — Engine power value in specified unit.
      - `unit` 'KILOWATT' | 'HORSEPOWER', required — Unit for measuring engine power.
    - `manufacturingStartDate` MonthAndYear — Represents a month in a specific year.
      - `year` number — Year in YYYY format
      - `month` number — Month in MM format
    - `manufacturingStopDate` MonthAndYear — Represents a month in a specific year.
      - `year` number — Year in YYYY format
      - `month` number — Month in MM format
    - `lastProcessedDate` string — The date on which the vehicle was last updated, in ISO-8601 date/time format.
    - `status` 'ACTIVE' | 'DELETED' — Status of vehicle in Amazon's catalog.
    - `identifiers` VehicleIdentifiers[], required — Identifiers that can be used to identify the vehicle uniquely
      - `standard` 'KTYPE' | 'AMAZON_ID', required — Standard followed to uniquely identify a vehicle.
      - `value` string, required — Id that can uniquely identify a vehicle based the vehicle identification standard.

## Other responses

- `400` — Request has missing or invalid parameters and cannot be parsed.
- `403` — Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
- `404` — The resource specified does not exist.
- `413` — The request size exceeded the maximum accepted size.
- `415` — The request payload is in an unsupported format.
- `429` — The frequency of requests was greater than allowed.
- `500` — An unexpected condition occurred that prevented the server from fulfilling the request.
- `503` — Temporary overloading or maintenance of the server.

---

[API](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01.md) · [All operations](https://skmtc.net/aws-samples/apis/a-content-management-v2020-11-01/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/a-content-management-v2020-11-01/revisions/815a5b6dbaa6/schema)