Skip to main content
POST
/
parties
curl --request POST \
  --url https://api.example.com/parties \
  --header 'Content-Type: application/json' \
  --data '
{
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "type": "INDIVIDUAL",
  "firstName": "John",
  "lastName": "Doe",
  "dateOfBirth": "1990-05-15",
  "nationality": "LT",
  "taxIdentifications": [
    {
      "tin": "39001010000",
      "country": "LT"
    }
  ],
  "documents": [
    {
      "type": "1",
      "number": "AB1234567"
    }
  ],
  "registrationAddress": {
    "streetName": "Main Street",
    "buildingNumber": "42",
    "postCode": "01234",
    "townName": "Vilnius",
    "country": "LT"
  }
}
'
{
  "type": "https://api.ledger.finventi.com/errors/bad-request",
  "title": "Bad Request",
  "status": 400,
  "detail": "Invalid request body: correlationId is required",
  "instance": "/accounts/019bdb2a-960f-789d-8955-21720e6cdeed"
}

Body

application/json

Party creation request

Request to create a party (individual or organisation)

​
correlationId
string<uuid>
required

Unique correlation identifier for tracking the request

Example:

"019bdb2a-960f-789d-8955-21720e6cdef0"

​
type
enum<string>
required

Party type

Available options:
INDIVIDUAL,
ORGANISATION
Example:

"INDIVIDUAL"

​
documents
object[]
required

Identification documents

​
uboDetails
object[]
required

Ultimate beneficial owners

​
representatives
object[]
required

Legal representatives

​
firstName
string | null

First name (required for INDIVIDUAL)

Example:

"John"

​
lastName
string | null

Last name (required for INDIVIDUAL)

Example:

"Doe"

​
dateOfBirth
string<date> | null

Date of birth

Example:

"1990-01-15"

​
nationality
string | null

Nationality (ISO 3166-1 alpha-2)

Example:

"LT"

​
taxIdentifications
object[] | null

Tax identifications (required for INDIVIDUAL)

​
registrationNumber
string | null

Registration number (required for ORGANISATION)

Example:

"123456789"

​
legalName
string | null

Legal name (required for ORGANISATION)

Example:

"Acme Corporation"

​
country
string | null

Country of registration (ISO 3166-1 alpha-2)

Example:

"LT"

​
registrationAddress
object

Registration address

Response

Party creation request accepted