---
title: "Update a company"
method: PATCH
path: "/v1/companies/{id}"
tags: ["Companies"]
---

# Update a company

`PATCH /v1/companies/{id}`

Updates the company with the given ID.

## Path parameters

- `id` string, uuid, required

## Request body

- CompanyUpdate
  - `name` string — Name for the company (at most 160 characters).
  - `commercial_name` string, nullable — Commercial name for the company (at most 160 characters).
  - `registration_number` string, nullable
  - `registration_date` string, date, nullable — Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
  - `status` 'live' | 'closed' | 'not_reported'
  - `legal_form` string, nullable
  - `entity_legal_form` string, nullable — [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code (eg: `6CHY`)
  - `country` string, alpha-2, nullable — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code (eg `FR`)
  - `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`)
  - `classifications` CompanyClassification[]
    - `type` string, required
    - `code` string, required
    - `description` string, nullable
  - `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.
  - `share_capital` string, nullable
  - `tax_identification_number` string, nullable
  - `website_url` string, nullable
  - `employer_identification_number` string, nullable
  - `custom_properties` object — Optional partial custom properties object in a format of `key` (string) / `value` (string | boolean | string[] | number | null) to update the company. Archived custom properties are not accepted.

## Response `200`

Returns information of the updated company

**ℹ️ Click to see full payload**

- Company
  - `id` string, uuid, required
  - `case_id` string, uuid, required
  - `type` 'main' | 'affiliated', required
  - `name` string, required
  - `is_relevant` boolean, required
  - `commercial_name` 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`)
  - `registration_number` string, nullable, required
  - `registration_date` string, date, nullable, required — Date in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)(`yyyy-MM-dd` eg `2023-01-31`)
  - `status` 'live' | 'closed' | 'not_reported', required
  - `legal_form` string, nullable, required
  - `entity_legal_form` string, nullable, required — [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code (eg: `6CHY`)
  - `entity_legal_form_label` string, nullable, required — Label in the origin country language of the [ISO 20275](https://www.gleif.org/en/about-lei/iso-20275-entity-legal-forms-code-list) code. May contains multiple labels separated with a comma `,` when the code is assigned to multiple label in different languages.
  - `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`)
  - `classifications` CompanyClassification[], nullable, required
    - `type` string, required
    - `code` string, required
    - `description` string, nullable
  - `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.
  - `share_capital` string, nullable, required
  - `tax_identification_number` string, nullable, required
  - `website_url` string, nullable, required
  - `employer_identification_number` string, nullable, required
  - `custom_properties` object, required — Custom properties object in a format of `key` (string) / `value` (string | boolean | string[] | number | null) to read the company. Archived custom properties are omitted.
  - `document_orders` DocumentOrder[], required
    - `id` string, uuid, required
    - `company_id` string, uuid, required
    - `product_ref` string, required
    - `name` string, required
    - `price_tier` string, required
    - `status` 'created' | 'processing' | 'completed' | 'failed', required
    - `file_id` 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`)
  - `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' | '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`)
  - `property_origins` object — Property origin details keyed by property path, returned only when `property_origin=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 company can be found.

---

[API](https://skmtc.dev/dotfile/apis/api-specifications.md) · [All operations](https://skmtc.dev/dotfile/apis/api-specifications/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dotfile/api-specifications/revisions/36393567057b/schema)