> ## 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.

# Get party

> Returns party details by ID



## OpenAPI

````yaml get /v1/parties/{id}
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/{id}:
    get:
      tags:
        - Parties
      summary: Get specific party
      description: Returns party by ID
      parameters:
        - description: Party ID
          example: 019bdb2a-960f-789d-8955-21720e6cdeed
          name: id
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/UUID'
      responses:
        '200':
          description: Party details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPartyResponse'
        '404':
          description: Party not found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Internal server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
components:
  schemas:
    UUID:
      format: uuid
      pattern: >-
        [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}
      type: string
    GetPartyResponse:
      description: Party details
      type: object
      properties:
        id:
          format: uuid
          description: Party ID
          pattern: >-
            [a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}
          type: string
          example: 019bdb2a-960f-789d-8955-21720e6cdeed
        type:
          description: Party type
          type: string
          allOf:
            - $ref: '#/components/schemas/PartyType'
        originPartyId:
          description: Origin party identifier
          type: string
          example: 1f770bac-670a-40fc-9deb-0a691034495a
        firstName:
          description: First name (individual)
          type: string
          example: John
          nullable: true
        lastName:
          description: Last name (individual)
          type: string
          example: Doe
          nullable: true
        dateOfBirth:
          format: date
          description: Date of birth (individual)
          type: string
          example: '1990-01-15T00:00:00.000Z'
          nullable: true
        nationality:
          description: Nationality (individual)
          type: string
          example: LT
          nullable: true
        taxIdentifications:
          description: Tax identifications (individual)
          type: array
          items:
            $ref: '#/components/schemas/TaxIdentificationResponse'
          nullable: true
        documents:
          description: Identification documents (individual)
          type: array
          items:
            $ref: '#/components/schemas/IdentificationDocumentResponse'
          nullable: true
        registrationNumber:
          description: Registration number (organisation)
          type: string
          example: '123456789'
          nullable: true
        legalName:
          description: Legal name (organisation)
          type: string
          example: Acme Corp
          nullable: true
        country:
          description: Country (organisation)
          type: string
          example: LT
          nullable: true
        uboDetails:
          description: UBO details (organisation)
          type: array
          items:
            $ref: '#/components/schemas/UboResponse'
          nullable: true
        representatives:
          description: Representatives (organisation)
          type: array
          items:
            $ref: '#/components/schemas/RepresentativeResponse'
          nullable: true
        registrationAddress:
          description: Registration address
          type: object
          allOf:
            - $ref: '#/components/schemas/AddressResponse'
          nullable: true
        createdAt:
          format: date-time
          description: Party creation timestamp
          type: string
          example: '2026-01-22T13:47:21.542Z'
        updatedAt:
          format: date-time
          description: Party last update timestamp
          type: string
          example: '2026-01-22T13:47:21.542Z'
    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
    TaxIdentificationResponse:
      description: Tax identification details
      type: object
      properties:
        tin:
          description: Tax identification number
          type: string
          example: '12345678901'
          nullable: true
        country:
          description: Country code
          type: string
          example: LT
          nullable: true
    IdentificationDocumentResponse:
      description: Identification document details
      type: object
      properties:
        type:
          description: Document type
          type: string
          example: PASSPORT
        number:
          description: Document number
          type: string
          example: AB1234567
    UboResponse:
      description: UBO details
      type: object
      properties:
        firstName:
          description: First name
          type: string
          example: John
        lastName:
          description: Last name
          type: string
          example: Doe
        taxIdentifications:
          description: Tax identifications
          type: array
          items:
            $ref: '#/components/schemas/TaxIdentificationResponse'
        dateFrom:
          format: date
          description: Date from
          type: string
          example: '2020-01-01T00:00:00.000Z'
        dateOfBirth:
          format: date
          description: Date of birth
          type: string
          example: '1990-01-15T00:00:00.000Z'
          nullable: true
        registrationAddress:
          description: Registration address
          type: object
          allOf:
            - $ref: '#/components/schemas/AddressResponse'
          nullable: true
        documents:
          description: Identification documents
          type: array
          items:
            $ref: '#/components/schemas/IdentificationDocumentResponse'
    RepresentativeResponse:
      description: Representative details
      type: object
      properties:
        firstName:
          description: First name
          type: string
          example: Jane
        lastName:
          description: Last name
          type: string
          example: Smith
        taxIdentifications:
          description: Tax identifications
          type: array
          items:
            $ref: '#/components/schemas/TaxIdentificationResponse'
        dateFrom:
          format: date
          description: Date from
          type: string
          example: '2020-01-01T00:00:00.000Z'
        dateOfBirth:
          format: date
          description: Date of birth
          type: string
          example: '1990-01-15T00:00:00.000Z'
          nullable: true
        registrationAddress:
          description: Registration address
          type: object
          allOf:
            - $ref: '#/components/schemas/AddressResponse'
          nullable: true
        documents:
          description: Identification documents
          type: array
          items:
            $ref: '#/components/schemas/IdentificationDocumentResponse'
    AddressResponse:
      description: Address details
      type: object
      properties:
        townName:
          description: Town name
          type: string
          example: Vilnius
          nullable: true
        streetName:
          description: Street name
          type: string
          example: Gedimino pr.
          nullable: true
        buildingNumber:
          description: Building number
          type: string
          example: '1'
          nullable: true
        postCode:
          description: Post code
          type: string
          example: '01103'
          nullable: true
        country:
          description: Country code
          type: string
          example: LT
          nullable: true

````