---
title: "Update entity"
method: PATCH
path: "/financial-data/v2/entities/{id}"
tags: ["Entities"]
---

# Update entity

`PATCH /financial-data/v2/entities/{id}`

Update an entity.

## Path parameters

- `id` string, required

## Headers

- `If-Match` string

## Response `200`

The updated entity.

- Entity
  - `id` string, required — Unique resource identifier.
  - `organizationId` string, required — Unique resource identifier for an Organization.
  - `parentId` string — This optional field identifies a parent entity, indicating this entity is a subsidiary or branch to the parent. A missing Parent Entity ID implies the entity is without parent company.
  - `legalName` string, required — Legal name of the entity. E.g. your company's legal business name.
  - `nationalIdentifier` NationalIdentifier
    - `type` 'CIVIC' | 'COMPANY', required — Type of the national identifier.
    - `market` string, required — Two-letter ISO 3166-1 alpha2 country code.
    - `number` string, required — The identifier itself.
  - `address` Address — Postal address.
    - `country` string — Two-letter ISO 3166-1 alpha2 country code.
    - `countrySubdivision` string — Country subdivision code (second part of the ISO 3166-2 code). E.g. state code `CA` for the state of California in the USA, `ON` for the province of Ontario in Canada, `NSW` for the state of New South Wales in Australia. ISO 3166-2 codes can be found on the ISO website, for example, for the USA: https://www.iso.org/obp/ui/#iso:code:3166:US. In the USA the state code is required for domestic payments, in Canada the province code is required for domestic payments.
    - `city` string
    - `postalCode` string
    - `streetName` string
    - `streetNumber` string
  - `created` string, date-time, required — Time at which the resource was created.
  - `updated` string, date-time, required — Time at which the resource was last updated.
  - `version` integer, required — Resource version. Starts at value `1` when the resource is created and increases by one for each successive update.

## Other responses

- `400` — Bad request.

---

[API](https://skmtc.net/atlar/apis/atlar-api-v2.md) · [All operations](https://skmtc.net/atlar/apis/atlar-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlar/atlar-api-v2/revisions/9c5e194ccf5d/schema)