# Get by ID

**GET /v1/stock/{stockId}**




## Servers
- Stock API: https://api.dealerauction.co.uk (Stock API)


## Authentication methods
- Basic


## Parameters

### Path parameters
- **stockId** (string)




## Responses
### 200
OK

#### Body: application/json (object)
- **id** (string)

- **listingId** (string)
  Your listing ID. You can retrieve real time listing information from the Listings resource using this identifier
- **createdDate** (string(date-time))

- **updatedDate** (string(date-time))

- **publicReference** (string)
  Forms part of the public url for the listing
- **metadata** (object)

- **lifecycleState** (string)
  The status of the vehicle
- **customerId** (string)
  Our customer ID that has been assigned to you. 
  Depending on account setup, you may have multiple customer account IDs assigned to you.
- **vehicle** (object)

- **advert** (object)

- **features** (array[object])
  List of features. If you don't have any, just provide an empty list
- **conditionReportUrl** (string)
  An externally hosted condition report can be associated to the stock item. This report must be in PDF format.
  When a condition report is added to a stock item, it will be asynchronously downloaded.
  The report is then scanned for viruses before being uploaded to our CDN.
- **condition** (object)

- **videoUrl** (string)
  An externally hosted video URL that we will embed in our listing page. Currently we only support YouTube.
- **images** (array[object])
  A list of image URLs that will be downloaded and then uploaded to our CDN.
  Images must be publicly accessible. We will require at least one image.

  Images will be displayed on the advert in the order that they are given. If you wish to reorder the images then resubmit the URLs in the order you would like.
- **capTaxonomy** (object)

- **availableUntil** (string(date-time))
  We will not attempt to sell the vehicle past this point in time. If an availableUntil is specified, auction time must end before or at this point. Any ongoing negotiations for provisional vehicles will also be abandoned past this point.
- **requestedNetwork** (string)
  The network that you would like the vehicle to be placed into.

   Depending on your account configuration, there may be multiple networks available to you.
  If no network is specified, then we will choose the most suitable network for the vehicle.
- **advertiser** (object)

- **additionalData** (object)
  A collection of questions and answers and notes from consumers selling vehicles through Consumer Direct

### 400
Bad Request

#### Body: application/json (object)
- **errorCode** (string)

- **errorMessage** (string)

- **errors** (array[object])


### 403
Forbidden

#### Body: application/json (object)
- **errorCode** (string)

- **errorMessage** (string)


### 404
Not Found

#### Body: application/json (object)
- **errorCode** (string)

- **errorMessage** (string)


### 409
Conflict

#### Body: application/json (object)
- **errorCode** (string)

- **vrm** (string)


### 429
Too Many Requests

#### Body: application/json (object)
- **errorCode** (string)

- **errorMessage** (string)


### 500
Internal Server Error

#### Body: application/json (object)
- **errorCode** (string)

- **errorMessage** (string)


### 502
Bad Gateway

#### Body: application/json (object)
- **errorCode** (string)

- **errorMessage** (string)



[Powered by Bump.sh](https://bump.sh)