Evaluations

Update evaluation details and mark it Complete

First call on an EvalID writes recon / customer / owner and marks the eval Complete so it appears in the apps. Later calls overwrite the same fields.

Appraisal amount: price (also accepted as finalprice / FinalPrice). Stored as FinalPrice on /geteval. UserPrices is offer/guide history and is not filled by this field.

Salesperson: userEmail from /getuserlist. /entervin has no user parameter, so the eval is created against the user linked to the API key; send userEmail on the first /dcupdateeval so it appears in that salesperson's app. Managers, dashboards, /geteval, and /getevallist see it either way. Sending userEmail on an already-complete eval reassigns it.

Mileage: km is required on the first complete. Condition: integer 0–10 (0 unroadworthy, 10 showroom).

GCC: gccPriceGuide=true returns GCC pricing data on the response.

Timestamps in the response: CreatedAt, CompletedAt and UpdatedAt are ISO-8601 UTC, read after this call's writes, so CompletedAt is populated on the call that completes the eval. EntryDate here is the creation time in UTC with no designator and is kept for backwards compatibility.

post/dcupdateeval

Request

  • Base URL: https://evalexpert.io/v1
  • URL: https://evalexpert.io/v1/dcupdateeval
  • 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 required

EvalID from /entervin or /manualcarentry

kminteger required

Odometer. Required the first time this eval is completed.

notesstring
conditioninteger

Condition score 0–10

vinstring
sparekeyinteger

1 = yes, 0 = no. Omit if unknown.

serviceinteger

6 Full Mixed, 5 Full Genuine, 4 Full Non-Genuine, 3 Partial, 2 Missing book / none. 1/0 are legacy.

financedinteger

1 = yes, 0 = no. Omit if unknown.

financenamestring
financeamtinteger
financepmtinteger

Monthly repayment

recondetailnumber
recontyresinteger

Number of tyres to replace

reconrimsnumber
reconpaintnumber
reconintnumber
reconregonumber
reconscreennumber
reconrwcnumber
wtymthinteger
wtyyearinteger
svcmthinteger
svcyearinteger
cNamestring
cPhonestring
cEmailstring
cPCodestring
cStatestring
cAddressstring
cSuburbstring
customFieldsobject

Custom customer fields keyed by their exact configured names. Available names, types, options, and current values are returned by /geteval in customFields.

priceinteger

Appraisal amount stored as FinalPrice

finalpriceinteger

Alias for price

FinalPriceinteger

Alias for price

pricingAiboolean

Include the Pricing AI payload on the response

reasoningboolean

With pricingAi, include AI reasoning

userEmailstring

Salesperson email from /getuserlist

gccPriceGuideboolean

GCC only. Return GCC pricing on the response.

Response

Full appraisal after the update

Changes

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