Evaluations

Get a completed evaluation

Returns matching completed evaluations. One of evalid, vin, or reg / registration is required. Same shape as the webhook body.

user is the user id or email to read on behalf of (must be in the same dealer group). It is not a customer field. If omitted, the user linked to the API key is used.

FinalPrice is the appraisal amount set on /dcupdateeval. UserPrices is offer/guide history (empty array when none exist). UserName / UserEmail identify the salesperson. Eval Link captures use a generated account (UserName begins Eval Link -, UserEmail ends .evallink@algodriven.xyz); filter on that suffix, do not treat it as a mailbox.

reconditioning_list is the same line items as the evaluation details page. Reconditioning stays the dollar total. A Tesla battery SoH reading is an item with type info, source tesla, cost 0, and value such as 93.3%.

/retrieveevals remains the in-app endpoint (single-user, pastevals envelope, 201). /geteval and /getevallist are the EvalExpert API product.

post/geteval

Request

  • Base URL: https://evalexpert.io/v1
  • URL: https://evalexpert.io/v1/geteval
  • Auth: API key in header Authorization

Headers

X-Dealer-Idstring

Rooftop to act as. Value is the dealer's uid (not the numeric DealerID). Required on a multi-rooftop partner key; ignored when the key is already bound to a single dealer.

Request body

evalidinteger

EvalID from /entervin

vinstring

Returns every completed eval in the dealer group for that VIN

regstring

Registration / plate

registrationstring

Alias for reg

statestring

Jurisdiction if looking up by plate

userstring

User id or email to read on behalf of

Response

Array of Evaluation objects (more than one when searching by vin or reg).

IDstring

Evaluation unique ID

EntryDatestring

Legacy. Creation time rendered in the dealer's local timezone with no zone designator (YYYY-MM-dd hh:mm:ss). Use CreatedAt instead.

CreatedAtstring date-time

When the evaluation was created. ISO-8601 UTC, e.g. 2026-09-04T22:40:29Z.

CompletedAtstring date-time nullable

When the evaluation was first marked Complete. ISO-8601 UTC. Null while in progress.

UpdatedAtstring date-time nullable

Last write to the evaluation row. ISO-8601 UTC.

UserNamestring

Salesperson name. Eval Link captures begin "Eval Link -"

UserEmailstring

Salesperson email. Eval Link captures end .evallink@algodriven.xyz (not a mailbox).

VINstring
EngineNostring
KMstring
Descriptionstring
Makestring
Modelstring
Variantstring
Seriesstring
MYstring
BuildYrstring
BuildMthstring
CompYrstring
CompMthstring
Bodystring
Doorsstring
Seatsstring
Fuelstring
Cylindersstring
Litresstring
Drivestring
Transmissionstring
Ext_Colourstring
Int_Colourstring
Registrationstring
RegExpirystring
SpareKeystring

1 spare key, 0 none

ServiceHistorystring

5 Full Genuine, 4 Full Non-Genuine, 3 Partial, 2 Missing book, 1/0 legacy, null unknown

Conditionunknown
Reconditioningunknown
Tradedunknown
Statusstring

TRADED, PURCHASED, PENDING, LOST_SOLD_ELSEWHERE, LOST_CUSTOMER_KEEPING, LOST_NOT_PURCHASING_FROM_US, LOST_NOT_BUYING_ANYMORE, or null

Notesstring
CarPicsstring[]
FinalPriceunknown
Ccystring
URLstring uri

Open the eval in EvalExpert

Changes

No recorded changes to this operation across all 1 revision of this API.