---
title: "Create an appraisal"
method: POST
path: "/appraisals"
tags: ["Appraisals"]
---

# Create an appraisal

`POST /appraisals`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/appraisals`
- Auth: `appAuth` (a scheme the document does not define)

Creates an appraisal associated to the requested property

## Headers

- `AgencyRef` string, required

## Request body

- AltoAppraisalApiModelsRequestsCreateAppraisalRequest
  - `propertyId` string, nullable: [Required] The unique identifier of the property to associate to the appraisal
  - `startDate` string, nullable: [Required] The start date and time of the appraisal
  - `endDate` string, nullable: [Required] The end date and time of the appraisal
  - `appraiserIds` string[], nullable: [Required] The unique identifiers of the appraisers, maximum of two appraisers
  - `type` 'Unspecified' | 'FreeMarketAppraisal' | 'BuildingSociety' | 'ABIData' | 'AgencyScheme' | 'Agricultural' | 'InsuranceCompany' | 'Bank' | 'ChargeableValuation' | 'Commercial' | 'CompulsoryPurchaseOrder' | 'Development' | 'Divorce' | 'FamilyDivision' | 'FormalMarketValuation' | 'HomebuyersPrivate' | 'HomebuyersReport' | 'Industrial' | 'Matrimonial' | 'PartExchange' | 'Probate' | 'ReMortgage' | 'Rental' | 'Repossession' | 'RevenueAndCustoms' | 'RightToBuy'
  - `notes` string, nullable: [Optional] Diary notes for the appraisal
  - `reminderMinutes` integer: [Optional] Reminder minutes prior to the appraisal
  - `reminderDeliveryType` 'Unspecified' | 'Screen' | 'SMS' | 'Both'
  - `requestingUserId` string, nullable: [Required] The unique identifier of the requesting user

## Response `201`

Returns the unique identifier of the newly created appraisal

- integer

## Other responses

- `400`: When the request does not contain the expected information
- `401`: When access has not been granted

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)