End listing early

POST /v1/testing/set-auction-end-time
Basic

This endpoint can be used to end your listing early which can be useful for end to end testing.

This endpoint will only work in our test environment.

application/json

Body Required

  • listingId string

    If listing ID is supplied then that will be the listing that is processed and stock ID will be ignored.

  • stockId string

    If stock ID is supplied instead of listing ID then we will retrieve the latest listing and process it.

  • endTime string(date-time)

Responses

  • 200

    OK

  • 400 application/json

    Bad Request

    Hide response attributes Show response attributes object
    • errorCode string Required
    • errorMessage string
    • errors array[object]
      Hide errors attributes Show errors attributes object
      • message string Required
      • key string
  • 403 application/json

    Forbidden

    Hide response attributes Show response attributes object
    • errorCode string Required
    • errorMessage string
  • 404 application/json

    Not Found

    Hide response attributes Show response attributes object
    • errorCode string Required
    • errorMessage string
  • 409 application/json

    Conflict

    Hide response attributes Show response attributes object
    • errorCode string Required
    • vrm string
  • 502 application/json

    Bad Gateway

    Hide response attributes Show response attributes object
    • errorCode string Required
    • errorMessage string
POST /v1/testing/set-auction-end-time 
curl \
 --request POST 'https://api.dealerauction.co.uk/v1/testing/set-auction-end-time' \
 --user "username:password" \
 --header "Content-Type: application/json" \
 --data '{"listingId":"string","stockId":"string","endTime":"2025-05-04T09:42:00Z"}'
Request examples 
{
  "listingId": "string",
  "stockId": "string",
  "endTime": "2025-05-04T09:42:00Z"
}
Response examples (400) 
{
  "errorCode": "INVALID_STOCK_ITEM",
  "errorMessage": "An error message",
  "errors": [
    {
      "message": "An error has occurred",
      "key": "string"
    }
  ]
}
Response examples (403) 
{
  "errorCode": "SERVER_ERROR",
  "errorMessage": "An unexpected error has occurred"
}
Response examples (404) 
{
  "errorCode": "SERVER_ERROR",
  "errorMessage": "An unexpected error has occurred"
}
Response examples (409) 
{
  "errorCode": "STOCK_ALREADY_EXISTS",
  "vrm": "AB17ABC"
}
Response examples (502) 
{
  "errorCode": "SERVER_ERROR",
  "errorMessage": "An unexpected error has occurred"
}