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

# Read an associated party

> This endpoint reads an associated party of a business customer.



## OpenAPI

````yaml /openapi/api-production.yaml get /customers/{id}/associated-parties/{associatedPartyId}
openapi: 3.1.0
info:
  version: 1.0.0
  title: Lumx API
  description: >-
    A cross-border banking API with instant settlements and unmatched liquidity,
    powered by stablecoins.
servers:
  - url: https://api.lumx.io
  - url: https://api-sandbox.lumx.io
security: []
paths:
  /customers/{id}/associated-parties/{associatedPartyId}:
    get:
      tags:
        - Customers
      summary: Read an associated party
      description: This endpoint reads an associated party of a business customer.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Customer's unique identifier.
        - name: associatedPartyId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Associated party's unique identifier.
      responses:
        '200':
          description: Associated party successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssociatedPartyResponse'
      security:
        - apiKey: []
components:
  schemas:
    AssociatedPartyResponse:
      oneOf:
        - $ref: '#/components/schemas/AssociatedPartyIndividualResponse'
        - $ref: '#/components/schemas/AssociatedPartyBusinessResponse'
    AssociatedPartyIndividualResponse:
      title: Individual
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Associated party's unique identifier.
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        type:
          type: string
          enum:
            - INDIVIDUAL
        roles:
          type: array
          items:
            type: string
            enum:
              - UBO
              - SHAREHOLDER
              - REPRESENTATIVE
        name:
          type: string
          example: Maria Santos
        taxId:
          type: string
          example: 987.654.321-00
        birthDate:
          type: string
          format: date
          example: '1985-07-10'
        email:
          type: string
          format: email
          example: maria.santos@example.com
        address:
          $ref: '#/components/schemas/Address'
        ownershipPercentage:
          type: number
          example: 40
        parentId:
          type: string
          format: uuid
          description: >-
            Parent associated party ID. Used for multi-level corporate
            structures, allowing you to nest shareholders across 2, 3, or more
            levels of ownership hierarchy.
        verification:
          $ref: '#/components/schemas/CustomerVerification'
        createdAt:
          type: string
          format: date-time
          example: '2024-01-15T11:00:00Z'
        updatedAt:
          type: string
          format: date-time
          example: '2024-01-15T11:00:00Z'
    AssociatedPartyBusinessResponse:
      title: Business
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Associated party's unique identifier.
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        type:
          type: string
          enum:
            - BUSINESS
        roles:
          type: array
          items:
            type: string
            enum:
              - SHAREHOLDER
        legalName:
          type: string
          example: Investment Fund ABC
        taxId:
          type: string
          example: 99.988.877/0001-66
        incorporationDate:
          type: string
          format: date
          example: '2010-05-20'
        email:
          type: string
          format: email
          example: contact@fundabc.com
        address:
          $ref: '#/components/schemas/Address'
        ownershipPercentage:
          type: number
          example: 25
        parentId:
          type: string
          format: uuid
          description: >-
            Parent associated party ID. Used for multi-level corporate
            structures, allowing you to nest shareholders across 2, 3, or more
            levels of ownership hierarchy.
        verification:
          $ref: '#/components/schemas/CustomerVerification'
        createdAt:
          type: string
          format: date-time
          example: '2024-01-15T11:00:00Z'
        updatedAt:
          type: string
          format: date-time
          example: '2024-01-15T11:00:00Z'
    Address:
      type: object
      description: Address information.
      properties:
        country:
          type: string
          description: Country code (ISO 3166-1 alpha-3).
          example: BRA
        line1:
          type: string
          description: Street address.
          example: Rua das Flores, 123
        city:
          type: string
          description: City name.
          example: São Paulo
        state:
          type: string
          description: State or province code.
          example: SP
        postalCode:
          type: string
          description: Postal or ZIP code.
          example: 01234-567
      required:
        - country
        - line1
        - city
        - state
        - postalCode
    CustomerVerification:
      type: object
      description: Customer's verification.
      properties:
        status:
          type: string
          description: Verification status.
          enum:
            - NOT_STARTED
            - UNDER_VERIFICATION
            - APPROVED
            - TEMPORARY_REJECTION
            - FINAL_REJECTION
          example: NOT_STARTED
        level:
          type: string
          description: Verification level.
          enum:
            - STANDARD
          example: STANDARD
        link:
          type: string
          description: Verification link.
          example: https://in.sumsub.com/websdk/p/sbx_aA00bB11cC33dD44
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Bearer authentication header on the format `Bearer <API_KEY>`.

````