> ## 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. # Create party > Creates an individual or organisation party. Returns 202 Accepted when the request is queued for processing. ## OpenAPI ````yaml post /v1/parties openapi: 3.0.3 info: title: Ledger Client API version: 1.0.0 description: API for ledger operations - parties, accounts, transactions servers: [] security: [] tags: - name: Account Statements description: Retrieve account transaction history - name: Accounts description: Account management operations - name: Open Banking - Accounts description: PSD2 Account Information Service (AIS) - Account endpoints - name: Open Banking - Funds Confirmation description: PSD2 Confirmation of Funds Service (PIIS) - name: Open Banking - Payments description: PSD2 Payment Initiation Service (PIS) - name: Open Banking - Transactions description: PSD2 Account Information Service (AIS) - Transaction endpoints - name: Parties description: Party management operations - name: Payments description: Payment operations - name: Transaction Postings description: Retrieve transaction postings - name: Transactions description: Transaction execution operations paths: /v1/parties: post: tags: - Parties summary: Create party description: Creates an individual or organisation party parameters: - description: >- Client-provided idempotency key. UUID v4 suggested, max 255 characters. example: 550e8400-e29b-41d4-a716-446655440000 required: true name: Idempotency-Key in: header schema: maxLength: 255 pattern: \S type: string requestBody: description: Party creation request content: application/json: examples: Individual: summary: Create individual party value: type: INDIVIDUAL originPartyId: b9de8f06-6332-4879-b6a4-97c4be513a4e firstName: John lastName: Doe dateOfBirth: '1990-05-15T00:00:00.000Z' nationality: LT taxIdentifications: - tin: '39001010000' country: LT documents: - type: '1' number: AB1234567 registrationAddress: streetName: Main Street buildingNumber: '42' postCode: '01234' townName: Vilnius country: LT Organisation: summary: Create organisation party value: type: ORGANISATION originPartyId: c3af9b12-7841-4a5e-9d2f-82e1a4b6c7d8 legalName: Acme Corporation registrationNumber: '123456789' country: LT uboDetails: - firstName: Jane lastName: Smith taxIdentifications: - tin: '39001010001' country: LT dateFrom: '2020-01-01T00:00:00.000Z' dateOfBirth: '1985-03-20T00:00:00.000Z' representatives: - firstName: Bob lastName: Johnson taxIdentifications: - tin: '39001010002' country: LT dateFrom: '2021-06-15T00:00:00.000Z' registrationAddress: streetName: Business Avenue buildingNumber: '100' postCode: '01001' townName: Vilnius country: LT schema: $ref: '#/components/schemas/CreatePartyRequest' required: true responses: '202': description: Party creation request accepted content: application/json: schema: $ref: '#/components/schemas/AcceptedResponse' '400': description: >- Validation failed. See [Error Handling](/ledger/error-handling) for the response shape. content: application/problem+json: schema: oneOf: - $ref: '#/components/schemas/ValidationProblem' - $ref: '#/components/schemas/Problem' '500': description: Internal server error content: application/problem+json: schema: $ref: '#/components/schemas/Problem' components: schemas: CreatePartyRequest: description: Request to create a party (INDIVIDUAL or ORGANISATION) required: - type - originPartyId - documents - uboDetails - representatives type: object properties: type: description: Party type type: string allOf: - $ref: '#/components/schemas/PartyType' example: INDIVIDUAL originPartyId: description: External origin party identifier type: string example: b9de8f06-6332-4879-b6a4-97c4be513a4e firstName: description: Required for INDIVIDUAL type: string example: John nullable: true lastName: description: Required for INDIVIDUAL type: string example: Doe nullable: true dateOfBirth: format: date description: Required for INDIVIDUAL outside Lithuania type: string example: '1990-01-15T00:00:00.000Z' nullable: true nationality: description: Required for INDIVIDUAL (ISO 3166-1 alpha-2) type: string example: LT nullable: true taxIdentifications: description: Required for INDIVIDUAL type: array items: $ref: '#/components/schemas/TaxIdentificationRequest' nullable: true documents: description: Required for INDIVIDUAL registered outside Lithuania type: array items: $ref: '#/components/schemas/IdentificationDocumentRequest' registrationNumber: description: Required for ORGANISATION type: string example: '123456789' nullable: true legalName: description: Required for ORGANISATION type: string example: Acme Corporation nullable: true country: description: Required for ORGANISATION (ISO 3166-1 alpha-2) type: string example: LT nullable: true uboDetails: description: >- Ultimate beneficial owners. Required for ORGANISATION registered outside Lithuania type: array items: $ref: '#/components/schemas/UboRequest' representatives: description: >- Legal representatives. Required for ORGANISATION registered outside Lithuania type: array items: $ref: '#/components/schemas/RepresentativeRequest' registrationAddress: description: >- Registration address. Required for ORGANISATION and INDIVIDUAL registered outside Lithuania type: object allOf: - $ref: '#/components/schemas/AddressRequest' nullable: true AcceptedResponse: description: Response for accepted asynchronous requests type: object properties: correlationId: description: Correlation identifier for tracking the request through events type: string example: 550e8400-e29b-41d4-a716-446655440000 ValidationProblem: description: >- RFC 9457 problem details with a `violations` array describing each failed constraint. required: - status - title - instance - violations type: object properties: status: format: int32 description: HTTP status code type: integer example: 400 title: description: Short, human-readable summary of the problem type type: string instance: description: URI reference identifying this occurrence of the problem type: string violations: description: List of validation constraint violations type: array items: $ref: '#/components/schemas/Violation' Problem: description: >- RFC 9457 problem details. See [Error Handling](/ledger/error-handling) for the response shape. required: - status - title - instance type: object properties: status: format: int32 description: HTTP status code type: integer example: 500 title: description: Short, human-readable summary of the problem type type: string instance: description: URI reference identifying this occurrence of the problem type: string detail: description: >- Human-readable explanation specific to this occurrence of the problem type: string nullable: true PartyType: description: Type of party enum: - INDIVIDUAL - ORGANISATION type: string TaxIdentificationRequest: description: Tax identification information required: - tin - country type: object properties: tin: description: Tax identification number pattern: \S type: string example: '39001010000' nullable: true country: description: Country code (ISO 3166-1 alpha-2) pattern: \S type: string example: LT nullable: true IdentificationDocumentRequest: description: Identification document required: - type - number type: object properties: type: description: |- Available options: 1 - Lithuanian passport 2 - Birth certificate 4 - Driver's licence 10 - Permanent LT resident permit 14 - Temporary LT resident permit 17 - Lithuanian ID card 18 - Non-Lithuanian passport 25 - Diplomatic passport 33 - Non-Lithuanian ID card 34 - EU resident permit type: string allOf: - $ref: '#/components/schemas/DocumentType' example: '1' nullable: true number: description: Document number pattern: \S type: string example: AB123456 nullable: true UboRequest: description: Ultimate beneficial owner information required: - firstName - lastName - taxIdentifications - dateFrom type: object properties: firstName: description: Required if UBO is provided pattern: \S type: string example: Jane nullable: true lastName: description: Required if UBO is provided pattern: \S type: string example: Smith nullable: true taxIdentifications: description: Required if UBO is provided minItems: 1 type: array items: $ref: '#/components/schemas/TaxIdentificationRequest' nullable: true dateFrom: format: date description: Required if UBO is provided type: string example: '2019-06-01T00:00:00.000Z' nullable: true dateOfBirth: format: date description: Required for non-Lithuanian organisations type: string example: '1975-03-20T00:00:00.000Z' nullable: true registrationAddress: description: Required for non-Lithuanian organisations type: object allOf: - $ref: '#/components/schemas/AddressRequest' nullable: true documents: description: Required for non-Lithuanian organisations type: array items: $ref: '#/components/schemas/IdentificationDocumentRequest' RepresentativeRequest: description: Legal representative information required: - firstName - lastName - taxIdentifications - dateFrom type: object properties: firstName: description: Required if representative is provided pattern: \S type: string example: John nullable: true lastName: description: Required if representative is provided pattern: \S type: string example: Doe nullable: true taxIdentifications: description: Required if representative is provided minItems: 1 type: array items: $ref: '#/components/schemas/TaxIdentificationRequest' nullable: true dateFrom: format: date description: Required if representative is provided type: string example: '2020-01-01T00:00:00.000Z' nullable: true dateOfBirth: format: date description: Required for non-Lithuanian organisations type: string example: '1980-05-15T00:00:00.000Z' nullable: true registrationAddress: description: Required for non-Lithuanian organisations type: object allOf: - $ref: '#/components/schemas/AddressRequest' nullable: true documents: description: Required if representative is provided type: array items: $ref: '#/components/schemas/IdentificationDocumentRequest' AddressRequest: description: Address information required: - townName - country type: object properties: streetName: type: string example: Main Street nullable: true buildingNumber: type: string example: '123' nullable: true postCode: type: string example: LT-01234 nullable: true townName: pattern: \S type: string example: Vilnius nullable: true country: description: ISO 3166-1 alpha-2 pattern: \S type: string example: LT nullable: true Violation: description: Single validation constraint violation required: - field - in - message type: object properties: field: description: Name of the field that failed validation type: string in: description: Part of the HTTP request where the violation occurred enum: - query - path - header - form - body type: string message: description: Human-readable description of the violation type: string DocumentType: description: Document type code enum: - '1' - '2' - '4' - '10' - '14' - '17' - '18' - '25' - '33' - '34' type: string ````