---
title: "Update an individual"
method: PATCH
path: "/v1/individuals/{id}"
tags: ["Individuals"]
---

# Update an individual

`PATCH /v1/individuals/{id}`

## Request

- Base URL: `https://api.dotfile.com`
- URL: `https://api.dotfile.com/v1/individuals/{id}`
- Auth: API key in header `X-DOTFILE-API-KEY`

Updates the individual with the given ID.

## Path parameters

- `id` string, uuid, required

## Request body

- IndividualUpdate
  - `first_name` string
  - `middle_name` string, nullable: May contain multiple middle names
  - `last_name` string
  - `maiden_name` string, nullable
  - `is_business_contact` boolean: Set to `true` if this individual should be contacted regarding the case, this will also make the `email` required.
  - `is_beneficial_owner` boolean: Set to true if this individual ultimately owns or controls the main company
  - `is_controlling_person` boolean: Set to true if this individual exercises control over the main company through means other than ownership (e.g. senior management, board member)
  - `is_delegator` boolean: Set to true if this individual is delegating its signing authority to the signatory of the case. Individual cannot be both delegator and signatory Not relevant individual cannot be delegator
  - `is_signatory` boolean: Set to true if this person has delegated authority to be a signatory of the case, this will also make the `email` required. Individual cannot be both signatory and delegator Not relevant individual cannot be signatory
  - `email` string, email, nullable: Required if individual `is_business_contact` is `true`. Must be a valid email as defined in the [HTML spec](https://html.spec.whatwg.org/multipage/input.html#valid-e-mail-address) (eg. must match the following JavaScript-compatible regular expression: ```/^[a-zA-Z0-9.!#$%&'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/```)
  - `birth_date` string, date, nullable: Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
  - `birth_country` string, alpha-2, nullable: [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
  - `birth_place` string, nullable
  - `gender` 'male' | 'female' | 'other', nullable: Gender of the individual
  - `nationalities` string[], nullable: Nationalities of the individual as ISO 3166-1 alpha-2 country codes
  - `address` PartialAddress
    - `street_address` string, nullable
    - `street_address_2` string, nullable
    - `postal_code` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `region` string, nullable
    - `country` string, alpha-2, nullable: [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
  - `banking_information` BankingInformation
    - `iban` string, nullable, required: [ISO 13616](https://en.wikipedia.org/wiki/International_Bank_Account_Number) IBAN (eg: `FR7630006000011234567890189`). Spaces will be removed and value upper-cased.
    - `bic` string, nullable, required: [ISO 9362](https://en.wikipedia.org/wiki/ISO_9362) BIC (eg: `AGRIFRPPXXX`). Spaces will be removed and value upper-cased.
  - `tax_identification_number` string, nullable
  - `social_security_number` string, nullable
  - `phone_number` string, e.164, nullable: [E.164](https://en.wikipedia.org/wiki/E.164) phoneNumber (eg `+XXXXXXXXXXX`)
  - `position` string, nullable
  - `ownership_percentage` number, nullable
  - `voting_rights_percentage` number, nullable
  - `roles` string[]: `legal_representative` `shareholder`
  - `custom_properties` object: Optional partial custom properties object in a format of `key` (string) / `value` (string | boolean | string[] | number | null) to update the individual. Archived custom properties are not accepted.

## Response `200`

Returns information of the updated individual

**ℹ️ Click to see full payload**

- Individual
  - `id` string, uuid, required
  - `case_id` string, uuid, required
  - `roles` string[], required: `legal_representative` `shareholder`
  - `is_beneficial_owner` boolean, required: Set to true if this individual ultimately owns or controls the main company
  - `is_controlling_person` boolean, required: Set to true if this individual exercises control over the main company through means other than ownership (e.g. senior management, board member)
  - `is_business_contact` boolean, required: Set to true if this individual should be contacted regarding the case
  - `is_delegator` boolean, required: Set to true if this individual is delegating its signing authority to the signatory of the case
  - `is_signatory` boolean, required: Set to true if this person has delegated authority to be a signatory of the case
  - `is_relevant` boolean, required
  - `first_name` string, required
  - `middle_name` string, nullable, required: May contain multiple middle names
  - `last_name` string, required
  - `maiden_name` string, nullable, required
  - `email` string, email, nullable, required
  - `birth_date` string, date, nullable, required: Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
  - `birth_country` string, alpha-2, nullable, required: [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
  - `birth_place` string, nullable, required
  - `gender` 'male' | 'female' | 'other', nullable, required: Gender of the individual
  - `nationalities` string[], nullable, required: Nationalities of the individual as ISO 3166-1 alpha-2 country codes
  - `address` Address, required
    - `street_address` string, nullable, required
    - `street_address_2` string, nullable, required
    - `postal_code` string, nullable, required
    - `city` string, nullable, required
    - `state` string, nullable, required
    - `region` string, nullable, required
    - `country` string, alpha-2, nullable, required: [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
  - `banking_information` BankingInformation, required
    - `iban` string, nullable, required: [ISO 13616](https://en.wikipedia.org/wiki/International_Bank_Account_Number) IBAN (eg: `FR7630006000011234567890189`). Spaces will be removed and value upper-cased.
    - `bic` string, nullable, required: [ISO 9362](https://en.wikipedia.org/wiki/ISO_9362) BIC (eg: `AGRIFRPPXXX`). Spaces will be removed and value upper-cased.
  - `tax_identification_number` string, nullable, required
  - `social_security_number` string, nullable, required
  - `phone_number` string, e.164, nullable, required: Phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format (eg `+33123456789`) [E.164](https://en.wikipedia.org/wiki/E.164) phoneNumber (eg `+XXXXXXXXXXX`)
  - `position` string, nullable, required
  - `ownership_percentage` number, float, nullable, required
  - `voting_rights_percentage` number, float, nullable, required
  - `custom_properties` object, required: Custom properties object in a format of `key` (string) / `value` (string | boolean | string[] | number | null) to read the individual. Archived custom properties are omitted.
  - `checks` Check[], required
    - `id` string, uuid, required
    - `individual_id` string, nullable, required
    - `company_id` string, nullable, required
    - `is_internal` boolean, required
    - `status` 'in_progress' | 'need_review' | 'processing' | 'approved' | 'rejected' | 'expired', required: ℹ️ Check status `expired` is deprecated and will be removed Q1'25. It will be replaced with an expired flag.
    - `type` 'id_verification' | 'id_document' | 'aml' | 'company_monitoring' | 'document' | 'ekyc' | 'electronic_signature' | 'email_phone_verification' | 'fraud_database' | 'online_reputation', required
    - `subtype` string, nullable, required: Contains the `subtype` for some check `type`: - `document`: Currently contains `"document_type:{document_type_key}"` - `electronic_signature`: Contains `"document_template:{document_template_key}"` - For all other check type, always contains `null`
    - `document_type_key` string: Set only for `document` Check with the document type key.
    - `created_at` string, date-time, required: Creation date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
    - `updated_at` string, date-time, required: Latest update date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
    - `last_activity_at` string, date-time, required: Latest activity date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `relations` CaseRelationOfEntity[], required
    - `id` string, uuid, required
    - `to_company_id` string, uuid, required
    - `voting_rights_percentage` number, float, nullable, required
    - `ownership_percentage` number, float, nullable, required
    - `roles` string[], required: `legal_representative` `shareholder`
    - `position` string, nullable, required
    - `created_at` string, date-time, required: Creation date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
    - `updated_at` string, date-time, required: Latest update date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `created_at` string, date-time, required: Creation date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `updated_at` string, date-time, required: Latest update date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `last_activity_at` string, date-time, required: Latest activity date Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `data_lineage` object: Data lineage keyed by property path, returned only when `data_lineage=true` is provided.

## Other responses

- `400`: The request is either malformed or contain invalid parameters. - Make sure the identifier specified in the URL is a valid UUID - Make sure the body payload matches the expected schema
- `404`: No individual can be found.

## Changes

- **2026-11-03** `50cab516e856`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dotfile/apis/api-specifications/changes/v1/individuals/:id/patch.md)

---

[API](https://skmtc.dev/dotfile/apis/api-specifications.md) - [All operations](https://skmtc.dev/dotfile/apis/api-specifications/llms.txt) - [OpenAPI document](https://skmtc.dev/dotfile/apis/api-specifications/revisions/50cab516e856?raw)