> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finventi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Party Updated

> Webhook notification sent when a party is successfully updated

<Note>
  This webhook is sent when a party (individual or organisation) has been successfully updated in the system.
</Note>

## Webhook Structure

<ParamField body="id" type="string (UUID)" required>
  Unique identifier for this event
</ParamField>

<ParamField body="time" type="string (ISO 8601)" required>
  Timestamp of when the event occurred
</ParamField>

<ParamField body="correlationId" type="string">
  Identifier to correlate the request with the response. Present when provided in the original request.
</ParamField>

<ParamField body="type" type="string" required>
  The type of event. Value: `party.updated`
</ParamField>

<ParamField body="data" type="object" required>
  The event data containing the details below
</ParamField>

### Data Fields

<ParamField body="data.partyId" type="string (UUID)" required>
  Unique identifier of the updated party
</ParamField>

<ParamField body="data.originPartyId" type="string" required>
  External origin party identifier
</ParamField>

<ParamField body="data.partyType" type="string" required>
  Type of the party. Available values: `INDIVIDUAL`, `ORGANISATION`
</ParamField>

<ParamField body="data.firstName" type="string">
  First name. Present for `INDIVIDUAL` parties.
</ParamField>

<ParamField body="data.lastName" type="string">
  Last name. Present for `INDIVIDUAL` parties.
</ParamField>

<ParamField body="data.dateOfBirth" type="string (ISO 8601 date)">
  Date of birth. Present for `INDIVIDUAL` parties.
</ParamField>

<ParamField body="data.nationality" type="string">
  Nationality code. Present for `INDIVIDUAL` parties.
</ParamField>

<ParamField body="data.taxIdentifications" type="array">
  Tax identification numbers

  <Expandable title="Tax identification object properties">
    <ParamField body="tin" type="string">
      Tax identification number
    </ParamField>

    <ParamField body="country" type="string">
      Country code
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="data.documents" type="array">
  Identification documents

  <Expandable title="Document object properties">
    <ParamField body="type" type="string" required>
      Document type
    </ParamField>

    <ParamField body="number" type="string" required>
      Document number
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="data.registrationNumber" type="string">
  Registration number. Present for `ORGANISATION` parties.
</ParamField>

<ParamField body="data.legalName" type="string">
  Legal name. Present for `ORGANISATION` parties.
</ParamField>

<ParamField body="data.country" type="string">
  Country code
</ParamField>

<ParamField body="data.registrationAddress" type="object">
  Registration address

  <Expandable title="Address object properties">
    <ParamField body="streetName" type="string">
      Street name
    </ParamField>

    <ParamField body="buildingNumber" type="string">
      Building number
    </ParamField>

    <ParamField body="postCode" type="string">
      Post code
    </ParamField>

    <ParamField body="townName" type="string">
      Town name
    </ParamField>

    <ParamField body="country" type="string">
      Country code
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="data.uboDetails" type="array">
  Ultimate beneficial owners. Present for `ORGANISATION` parties.

  <Expandable title="UBO object properties">
    <ParamField body="firstName" type="string" required>
      First name
    </ParamField>

    <ParamField body="lastName" type="string" required>
      Last name
    </ParamField>

    <ParamField body="taxIdentifications" type="array" required>
      Tax identification numbers
    </ParamField>

    <ParamField body="dateFrom" type="string (ISO 8601 date)" required>
      Date from which the UBO status applies
    </ParamField>

    <ParamField body="dateOfBirth" type="string (ISO 8601 date)">
      Date of birth
    </ParamField>

    <ParamField body="registrationAddress" type="object">
      Registration address
    </ParamField>

    <ParamField body="documents" type="array">
      Identification documents
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="data.representatives" type="array">
  Legal representatives. Present for `ORGANISATION` parties.

  <Expandable title="Representative object properties">
    <ParamField body="firstName" type="string" required>
      First name
    </ParamField>

    <ParamField body="lastName" type="string" required>
      Last name
    </ParamField>

    <ParamField body="taxIdentifications" type="array" required>
      Tax identification numbers
    </ParamField>

    <ParamField body="dateFrom" type="string (ISO 8601 date)" required>
      Date from which the representative status applies
    </ParamField>

    <ParamField body="dateOfBirth" type="string (ISO 8601 date)">
      Date of birth
    </ParamField>

    <ParamField body="registrationAddress" type="object">
      Registration address
    </ParamField>

    <ParamField body="documents" type="array">
      Identification documents
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="data.createdAt" type="string (ISO 8601)">
  Timestamp of when the party was created
</ParamField>

<ParamField body="data.updatedAt" type="string (ISO 8601)" required>
  Timestamp of when the party was updated
</ParamField>

## Request Example

```json theme={null}
{
  "id": "c3b8d6e5-1f4a-4c9d-b3e7-2a6f8d0c4e1b",
  "time": "2025-01-15T10:30:00Z",
  "correlationId": "7d3e1a4f-5b8c-42d6-9e0f-1a3c5d7b9e2f",
  "type": "party.updated",
  "data": {
    "partyId": "019cde41-fc63-7a9e-0e98-ac5f7a8d2b4e",
    "originPartyId": "b9de8f06-6332-4879-b6a4-97c4be513a4e",
    "partyType": "INDIVIDUAL",
    "firstName": "John",
    "lastName": "Doe",
    "dateOfBirth": "1990-01-15",
    "nationality": "LT",
    "taxIdentifications": [
      {
        "tin": "12345678901",
        "country": "LT"
      }
    ],
    "country": "LT",
    "createdAt": "2025-01-15T10:29:00Z",
    "updatedAt": "2025-01-15T10:30:00Z"
  }
}
```
