Valara

Submit an appraisal for review

POST
/reviews

Starts an asynchronous review. Returns 202 with a processing review, or 200 with a completed review when the same appraisal (by content hash) was reviewed before. Two transports: a JSON body referencing an uploaded blob, or a raw application/pdf body with parameters in the query string.

Authorization

apiKey reviews:write
AuthorizationBearer <token>

A Valara API key passed as Authorization: Bearer vlr_live_…. Scopes: reviews:read, reviews:write, reviews:delete.

In: header

Scope: reviews:write

Request Body

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/reviews" \  -H "Content-Type: application/json" \  -d '{    "blob_url": "http://example.com",    "filename": "string",    "review_type": "residential"  }'
{  "id": "string",  "object": "review",  "status": "processing",  "review_type": "residential",  "filename": "string",  "property_address": "string",  "appraisal_quality_score": 0,  "confidence_score": 0,  "error": "string",  "result_url": "string",  "created_at": "string",  "updated_at": "string"}
{  "id": "string",  "object": "review",  "status": "processing",  "review_type": "residential",  "filename": "string",  "property_address": "string",  "appraisal_quality_score": 0,  "confidence_score": 0,  "error": "string",  "result_url": "string",  "created_at": "string",  "updated_at": "string"}
{  "error": {    "type": "invalid_request",    "message": "string",    "param": "string",    "request_id": "string"  }}
{  "error": {    "type": "invalid_request",    "message": "string",    "param": "string",    "request_id": "string"  }}
{  "error": {    "type": "invalid_request",    "message": "string",    "param": "string",    "request_id": "string"  }}
{  "error": {    "type": "invalid_request",    "message": "string",    "param": "string",    "request_id": "string"  }}
{  "error": {    "type": "invalid_request",    "message": "string",    "param": "string",    "request_id": "string"  }}