Currently appraisal statuses feature is purely visual. There is no additional logic associated with each status.
This is an extra feature that is not enabled by default in the ValueChecker API. Contact our support to get this enabled for your account.

​
Get Available Appraisal Statuses

Retrieve all available appraisal statuses based on your client settings. This endpoint returns the list of statuses that can be applied to appraisals.
Use this endpoint first to understand what status options are available for your client before attempting to set appraisal statuses.
Get Available Appraisal Statuses Endpoint➜

​
Upsert Appraisal Status

Set or update the status for a specific appraisal.
The appraisal must exist before you can set its status. Create an appraisal first using the standard appraisal creation endpoint.
Only status IDs that are returned from the “Get Available Appraisal Statuses” endpoint can be used when updating an appraisal’s status.
Update Appraisal Status Endpoint➜

​
Get Appraisal with Status Information

When retrieving appraisal, the response will include the current appraisal status information if a status has been set.

​
Appraisal Status Workflow

1

Create an appraisal

Start by creating an appraisal for a client reference.
Create Appraisal Endpoint➜
2

Check available statuses

Get the list of available appraisal statuses for your client to see what status options you can use.
Get Available Appraisal Statuses Endpoint➜
3

Upsert appraisal status

Upsert appraisal status with an appropriate status.
Update Appraisal Status Endpoint➜
4

Retrieve appraisal with status

When retrieving appraisal details, the response will include the current status information.
Get Appraisal Details Endpoint➜
  • Open (1) - Initial status when an appraisal is created and available for review.
  • Accepted (2) - Status when the appraisal has been approved and accepted.
  • Rejected (3) - Status when the appraisal has been declined or rejected.
  • Closed (4) - Status when the appraisal process is completed and no further action is needed.
  • Flagged (5) - Status when the appraisal requires special attention or review.
  • Archived (6) - Status when the appraisal is stored for historical purposes and is no longer active.