---
title: "Update Applicant Requirement by Id"
method: PATCH
path: "/contacts/{contactId}/applicant-requirements/{requirementId}"
tags: ["Contacts"]
---

# Update Applicant Requirement by Id

`PATCH /contacts/{contactId}/applicant-requirements/{requirementId}`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/contacts/{contactId}/applicant-requirements/{requirementId}`
- Auth: `appAuth` (a scheme the document does not define)

## Path parameters

- `contactId` string, required
- `requirementId` string, required

## Headers

- `AgencyRef` string, required

## Request body

- SystemTextJsonPatchOperationsOperation1AltoContactsApiModelsRequestsPatchApplicantRequirement[]: Array of operations to perform
  - union
    - object: The Applicant's intention.
      - `op` 'replace'
      - `value` 'Buy' | 'Rent'
      - `path` string
    - object: Whether the Applicant requires a new build Property.
      - `op` 'replace'
      - `value` string
      - `path` string
    - object: Whether the Requirement is active in the Applicant's profile.
      - `op` 'replace'
      - `value` string
      - `path` string
    - object: The minimum price of the Property.
      - `op` 'replace'
      - `value` integer
      - `path` string
    - object: The maximum price of the Property.
      - `op` 'replace'
      - `value` integer
      - `path` string
    - object: The minimum number of bedrooms of the Property.
      - `op` 'replace'
      - `value` integer
      - `path` string
    - object: The frequency of the rental payment.
      - `op` 'replace'
      - `value` 'Weekly' | 'Monthly'
      - `path` string
    - object: The furnishing requirement of the desired property.
      - `op` 'replace'
      - `value` 'Furnished' | 'PartFurnished' | 'Unfurnished' | 'Unspecified'
      - `path` string
    - object: The tenure the Applicant is looking for.
      - `op` 'replace'
      - `value` 'Freehold' | 'Leasehold' | 'Unspecified'
      - `path` string
    - object: Free-text notes for the Requirement.
      - `op` 'replace'
      - `value` string
      - `path` string

## Response `200`

Returns the updated Applicant Requirement.

- AltoContactsApiModelsResponsesPatchApplicantRequirement
  - `id` string, nullable: The unique identifier for the resource.
  - `links` AltoApiMaterialHateoasLink[], nullable: Links to related entities.
    - `href` string, nullable
    - `rel` string, nullable
  - `profileIntention` 'Unspecified' | 'Buy' | 'Rent': The Applicant's intention.
  - `isNewBuild` boolean, nullable: Whether the Applicant requires a new build Property.
  - `isActiveProfile` boolean: Whether the Requirement is active in the Applicant's profile.
  - `priceFrom` integer, nullable: The minimum price of the Property.
  - `priceTo` integer, nullable: The maximum price of the Property.
  - `bedsMin` integer, nullable: The minimum number of bedrooms of the Property.
  - `rentalIntention` AltoContactsApiModelsResponsesRentalIntention
    - `priceQualifier` 'Unknown' | 'Weekly' | 'Monthly' | 'Quarterly' | 'Yearly' | 'AdHoc' | 'Daily' | 'Fortnightly' | 'FourWeekly' | 'MonthlyOnLastDay' | 'QuarterlyOnQuarterDays' | 'HalfYearly' | 'HalfYearlyOnQuarterDays'
    - `furnishing` 'Unspecified' | 'Unfurnished' | 'PartFurnished' | 'Furnished' | 'FurnishedOrUnfurnished', nullable
  - `tenureType` 'Unspecified' | 'Freehold' | 'Leasehold' | 'LeaseholdWithShareOfFreehold' | 'FlyingFreehold' | 'Commonhold' | 'ShareOfFreehold', nullable: The tenure the Applicant is looking for.
  - `notes` string, nullable: Free-text notes for the Requirement.

## Other responses

- `400`: Invalid Patch request.
- `404`: Applicant not found.

---

[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)