Skip to content

Identifiers ​

Retrieving identifiers by stock number ​

GET /v1/identifiers

Get the internal identifiers for a given seller and stock number.

curl --location --request POST '{baseUrl}/v1/identifiers?stockNumber={stockNumber}&realm={realm}' \
--header 'Authorization: Bearer {token}' \
--header 'Content-Type: application/json' \
--header 'x-seller-identifier: {sellerIdentifier}

Parameters ​

NameTypeDescription
tokenAuthorizationYou can obtain this token by following the Authentication guide.
sellerIdentifierGUIDIdentifies the dealer the ad will be posted to within carsales. carsales provides this for each dealer.
stockNumberstringThe vehicle stock number
realmstringThe realm to search in. Defaults to "carsales" (for Australian brands, including trucksales, bikesales etc. use "carsales"). Possible values are: carsales, chileautos, traderinteractive

Permissions ​

You must have the Inventory permission in order to use this endpoint.

Returns ​

Returns 200 Ok if the request succeeds. The payload contains the identifiers for the vehicle.

This call will return an error if something goes wrong.

Sample 200 Ok Response ​

json
{
  "Identifier": "5750ca27-8ec4-4a7b-828a-cd8dc91f0b7c",
  "StockNumber": "123456",
  "SellerIdentifier": "10a8108c-300f-45df-8f02-43513df1b6dd"
}