> ## Documentation Index
> Fetch the complete documentation index at: https://developer.valuechecker.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Appraisal Statuses

export const EndpointButton = ({title, href}) => <div className="button-container">
    <a className="button" href={href}>
      {title}
      <span className="arrow">➜</span>
    </a>
  </div>;

<Note>
  Currently appraisal statuses feature is purely visual. There is no additional
  logic associated with each status.
</Note>

<Warning>
  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.
</Warning>

## 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.

<Tip>
  Use this endpoint first to understand what status options are available for
  your client before attempting to set appraisal statuses.
</Tip>

<EndpointButton title="Get Available Appraisal Statuses Endpoint" href="/api-reference/default/client_reference-appraisal_statuses-get" />

## Upsert Appraisal Status

Set or update the status for a specific appraisal.

<Info>
  The appraisal must exist before you can set its status. Create an appraisal
  first using the standard appraisal creation endpoint.
</Info>

<Note>
  Only status IDs that are returned from the "Get Available Appraisal Statuses"
  endpoint can be used when updating an appraisal's status.
</Note>

<EndpointButton title="Update Appraisal Status Endpoint" href="/api-reference/default/client_reference-appraisal_status-put" />

## 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

<Steps>
  <Step title="Create an appraisal">
    Start by creating an appraisal for a client reference.

    <EndpointButton title="Create Appraisal Endpoint" href="/api-reference/default/client_reference-appraisal" />
  </Step>

  <Step title="Check available statuses">
    Get the list of available appraisal statuses for your client to see
    what status options you can use.

    <EndpointButton title="Get Available Appraisal Statuses Endpoint" href="/api-reference/default/client_reference-appraisal_statuses-get" />
  </Step>

  <Step title="Upsert appraisal status">
    Upsert appraisal status with an appropriate status.

    <EndpointButton title="Update Appraisal Status Endpoint" href="/api-reference/default/client_reference-appraisal_status-put" />
  </Step>

  <Step title="Retrieve appraisal with status">
    When retrieving appraisal details, the response will include the
    current status information.

    <EndpointButton title="Get Appraisal Details Endpoint" href="/api-reference/default/client_reference-appraisal" />
  </Step>
</Steps>

### Recommended `appraisal_status_id` usage.

* **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.
* **Paid** (7) - Status when the appraisal has been paid, but the claim is not yet closed.
* **Pending** (8) - Status when the appraisal is awaiting review, approval, or additional information before proceeding.