Get vehicle valuation

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://bump.sh/dealer-auction/doc/stock/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "stock MCP server": {
    "url": "https://bump.sh/dealer-auction/doc/stock/mcp"
  }
}
Close
POST /v1/consumer-direct-valuations
Basic

Bespoke valuation for our Consumer Direct sales channel. Only available for Consumer Direct seller accounts.

application/json

Body Required

  • vrm string

    Vehicle's registration for which to obtain valuation

  • mileage integer(int32)

    Vehicle's mileage in miles

Responses

  • 429 application/json

    Too Many Requests

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

    Internal Server Error

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

    Conflict

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

    Bad Gateway

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

    Not Found

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

    Bad Request

    One of:
    ErrorInfo object BadRequestErrorInfo object
  • 403 application/json

    Forbidden

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

    Unauthorized

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

    OK

    Hide response attribute Show response attribute object
    • valuation integer(int32)

      Calculated valuation based on the vehicles specification, as determined by the VRM, and mileage. Value formatted in GBP
POST /v1/consumer-direct-valuations 
curl \
 --request POST 'https://api.dealerauction.co.uk/v1/consumer-direct-valuations' \
 --user "username:password" \
 --header "Content-Type: application/json" \
 --data '{
  "vrm": "AA11 AAA",
  "mileage": 10000
}'
Request examples 
{
  "vrm": "AA11 AAA",
  "mileage": 10000
}
Response examples (429) 
{
  "errorCode": "SERVER_ERROR",
  "errorMessage": "An unexpected error has occurred"
}
Response examples (500) 
{
  "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"
}
Response examples (404) 
{
  "errorCode": "SERVER_ERROR",
  "errorMessage": "An unexpected error has occurred"
}
Response examples (400) 
{
  "errorCode": "SERVER_ERROR",
  "errorMessage": "An unexpected error has occurred"
}
{
  "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 (401) 
{
  "errorCode": "SERVER_ERROR",
  "errorMessage": "An unexpected error has occurred"
}
Response examples (200) 
{
  "valuation": 12345
}