Skip to main content

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.

This webhook is sent when a party (individual or organisation) has been successfully created in the system.

​
Webhook Structure

​
id
string (UUID)
required
Unique identifier for this event
​
time
string (ISO 8601)
required
Timestamp of when the event occurred
​
correlationId
string
Identifier to correlate the request with the response. Present when provided in the original request.
​
type
string
required
The type of event. Value: party.created
​
data
object
required
The event data containing the details below

​
Data Fields

​
data.partyId
string (UUID)
required
Unique identifier of the created party
​
data.originPartyId
string
required
External origin party identifier
​
data.partyType
string
required
Type of the party. Available values: INDIVIDUAL, ORGANISATION
​
data.firstName
string
First name. Present for INDIVIDUAL parties.
​
data.lastName
string
Last name. Present for INDIVIDUAL parties.
​
data.dateOfBirth
string (ISO 8601 date)
Date of birth. Present for INDIVIDUAL parties.
​
data.nationality
string
Nationality code. Present for INDIVIDUAL parties.
​
data.taxIdentifications
array
Tax identification numbers
​
data.documents
array
Identification documents
​
data.registrationNumber
string
Registration number. Present for ORGANISATION parties.
​
data.legalName
string
Legal name. Present for ORGANISATION parties.
​
data.country
string
Country code
​
data.registrationAddress
object
Registration address
​
data.uboDetails
array
Ultimate beneficial owners. Present for ORGANISATION parties.
​
data.representatives
array
Legal representatives. Present for ORGANISATION parties.
​
data.createdAt
string (ISO 8601)
Timestamp of when the party was created

​
Request Example

{
  "id": "a3f8e2b1-5c7d-4e9f-b8a2-1d4c6e9f0a3b",
  "time": "2025-01-15T10:30:00Z",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "type": "party.created",
  "data": {
    "partyId": "019bdb2a-960f-789d-8955-21720e6cdeed",
    "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:30:00Z"
  }
}
Last modified on April 24, 2026