Estimate

Estimate

post

Submit a soft credit check and get the latest credit score for a customer.

Authorizations

access_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Header parameters

x-dm-access-keystringRequired

The unique identifier of your dealer. Refer to Console > Dealers to get or setup your dealer access key.

x-api-keystringRequired

Your app's client ID.

Example: 47de026c-e52f-afc1-9214-063740bbce4d

Body

application/json

dealer_idintegerRequired

A unique ID that is assigned to dealerships for identification purposes.

Example: 10000

vinstring · vinOptional

The unique identification number or Vehicle Identification Number (VIN) that is assigned to all vehicles.

Example: 1GTHK24U85E335250

vehicle_idstringOptional

A unique vehicle identifier based on the integration partner.

Example: 12345456

mileageintegerOptional

Odometer miles of the vehicle.

Example: 23430

conditionstring · enumOptional

The condition of the vehicle supported by the integration partner.

Example: ExcellentPossible values:

zipstringOptional

Zip or postal code of address.

Example: 02215

vidstring · alphanumericRequired

Unique identifier that is passed by an external system.

Example: 123e4567-e89b-12d3-a456-426614174000

sidstring · alphanumericRequired

Unique session identifier that is passed by an external system.

Example: sese4567-e89b-12d3-a456-426614174000

Responses

200

The trade estimate.

application/json

400

Bad request.

404

Not found.

409

Conflict.

500

Unknown error occured.

post

/v1/trade/estimate

HTTPcURLJavaScriptPython

POST /v1/trade/estimate HTTP/1.1
Host: api.dealermesh.com
Authorization: Bearer YOUR_SECRET_TOKEN
x-dm-access-key: text
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 509

{
  "dealer_id": 10000,
  "vehicle": {
    "vehicle_id": "12345456",
    "vin": "1GTHK24U85E335250",
    "name": "2023 Acura TLX Premium Sport Sedan",
    "year": 2023,
    "make_name": "Acura",
    "model_name": "TLX",
    "trim_name": "Premium Sport Sedan",
    "body": "Sedan",
    "engine": "I6 3.0L Twin Turbo",
    "drivetrain": "RWD",
    "fuel_type": "Gas",
    "doors": 4,
    "options": []
  },
  "vin": "1GTHK24U85E335250",
  "vehicle_id": "12345456",
  "mileage": 23430,
  "condition": "Excellent",
  "zip": "02215",
  "vid": "123e4567-e89b-12d3-a456-426614174000",
  "sid": "sese4567-e89b-12d3-a456-426614174000"
}

{
  "trade_id": "774fds45-e89b-12d3-a456-426614174000",
  "vehicle": {
    "photos": [
      {
        "category": "trade",
        "upload_link": "https://dmsh.io/f3u4rd3",
        "link": "https://uploads.dm.com/files/774fds45-e89b-12d3-a456-426614174000",
        "content_type": "image/jpeg",
        "file_name": "Front.jpg"
      }
    ],
    "vehicle_id": "12345456",
    "vin": "1GTHK24U85E335250",
    "name": "2023 Acura TLX Premium Sport Sedan",
    "year": 2023,
    "make_name": "Acura",
    "model_name": "TLX",
    "trim_name": "Premium Sport Sedan",
    "body": "Sedan",
    "engine": "I6 3.0L Twin Turbo",
    "drivetrain": "RWD",
    "fuel_type": "Gas",
    "doors": 4,
    "options": []
  },
  "vin": "1GTHK24U85E335250",
  "vehicle_id": "12345456",
  "mileage": 23430,
  "condition": "Excellent",
  "zip": "02215",
  "value": 23430,
  "value_low": 22670,
  "value_high": 24310,
  "payoff": 4000,
  "status": 2,
  "report_url": "https://kbb.com/report/12342432423"
}