getVehicles

get https://sellingpartnerapi-na.amazon.com/catalog/2024-11-01/automotive/vehicles

Get the latest collection of vehicles

Responses

Response body

object

pagination

object

When a request produces a response that exceeds the pageSize, pagination occurs. This means the response is divided into individual pages. To retrieve the next page or the previous page, you must pass the nextToken value or the previousToken value as the pageToken parameter in the next request. When you receive the last page, there will be no nextToken key in the pagination object.

nextToken

string

A token that can be used to fetch the next page.

previousToken

string

A token that can be used to fetch the previous page.

vehicles

array of objects

required

List of vehicles from Amazon's catalog.

vehicles*

object

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

array of objects

length ≥ 1

Engine output of vehicle.

engineOutput

object

value

number

required

Engine power value in specified unit.

unit

string

required

Unit for measuring engine power.

KILOWATT HORSEPOWER

Show Details

KILOWATT	KILOWATT or kW is a unit used to measure engine power output.
HORSEPOWER	HORSEPOWER or HP is a unit used to measure engine power output.

manufacturingStartDate

object

Represents a month in a specific year.

manufacturingStopDate

object

Represents a month in a specific year.

lastProcessedDate

string

The date on which the vehicle was last updated, in ISO-8601 date/time format.

status

string

Status of vehicle in Amazon's catalog.

ACTIVE DELETED

Show Details

ACTIVE	Vehicle is active in Amazon's catalog.
DELETED	Vehicle is deleted from Amazon's catalog.

identifiers

array of objects

required

length ≥ 1

Identifiers that can be used to identify the vehicle uniquely

identifiers*

object

standard

string

required

Standard followed to uniquely identify a vehicle.

KTYPE AMAZON_ID

Show Details

KTYPE	Unique vehicle identification standard as provided by TecDoc
AMAZON_ID	Unique vehicle identification standard as provided by Amazon

value

string

required

Id that can uniquely identify a vehicle based the vehicle identification standard.

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://sellingpartnerapi-na.amazon.com/catalog/2024-11-01/automotive/vehicles?vehicleType=CAR' \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success.

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.