post

/v1/vehicles

Create a Vehicle record.

Note that this request automatically calculates a TrustScore for the new Vehicle based on the information provided.

To create a Vehicle without generating a TrustScore, include the propertytrigger_trustscore: false in the request payload. The Vehicle will be created with draft in the status field.

You can generate a new TrustScore for an existing Vehicle at any time by sending a GET request to ‘/v1/vehicles/{id}/trustscore’.

Authorization

bearer

Request Body

2 Examples
Schema
object
$schema: http://json-schema.org/draft-04/schema#
vehicle
object
1 validation + required

Responses

OK

Schema
object
$schema: http://json-schema.org/draft-04/schema#
id
integer

Unique id assigned to this Vehicle by DigiSURE.

4 validations + required
partner_vehicle_id
string

Unique id assigned to this Vehicle by your organization.

1 validation
type
string

Type of vehicle.

2 validations + required
subtype
string

vehicle sub type.

2 validations
make_name
string

Vehicle manufacturer name.

1 validation
model_name
string

Vehicle model name.

1 validation
trim_name
string

Trim name.

1 validation
year
integer

Four-digit year manufactured.

1 validation
odometer
integer

Odometer reading in miles.

1 validation
license_plate
string

Full license plate string.

1 validation + required
vin
string

vin (Vehicle Identification Number).

1 validation + required
custom_fields
object
owner
object
1 validation
created_at
string
2 validations
updated_at
string
2 validations
address
object
1 validation

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
$$.env
1 variable not set
bearer_token