---
title: "Get an associated entity by id and customer"
method: GET
path: "/v1/customers/{customerId}/associated_entities/{id}"
tags: ["Customers"]
---

# Get an associated entity by id and customer

`GET /v1/customers/{customerId}/associated_entities/{id}`

Retrieve details of a specific associated entity for a customer. If the entity has an active verification session, the `verificationLink` field will be populated.

## Path parameters

- `customerId` string, required
- `id` string, required

## Headers

- `X-API-Key` string

## Response `200`

Associated entity details retrieved successfully

- AssociatedEntityResponseDto
  - `id` string, required — Unique identifier
  - `createdAt` string, required — Created timestamp
  - `updatedAt` string, required — Last updated timestamp
  - `entityType` 'INDIVIDUAL' | 'BUSINESS', required — Type of entity
  - `parentEntityId` string — Parent entity ID for nested ownership. Use the associated business entity ID returned from the associated entity endpoints when linking a child owner beneath an intermediate business owner.
  - `details` union — Type-specific details (individual or business)
    - IndividualEntityDetailsDto
      - `firstName` string
      - `nickname` string
      - `lastName` string
      - `middleName` string
      - `dateOfBirth` string
      - `transliteratedFirstName` string
      - `transliteratedMiddleName` string
      - `transliteratedLastName` string
      - `taxIdentificationDocumentType` string
    - BusinessEntityDetailsDto
      - `businessName` string
      - `registrationNumber` string
      - `dateOfIncorporation` string
      - `businessAddress` AddressDto
        - `addressLine1` string, required — Address line 1
        - `addressLine2` string — Address line 2 (apartment, suite, etc.)
        - `city` string, required — City
        - `state` string — State / Province
        - `postalCode` string, required — Postal code / ZIP code. May be empty for countries without a postal-code system, including the United Arab Emirates.
        - `country` string, required — Country code (ISO 3166-2)
        - `transliterated` TransliteratedAddressDto
          - `addressLine1` string — Transliterated address line 1 (Latin characters)
          - `addressLine2` string — Transliterated address line 2 (Latin characters)
          - `city` string — Transliterated city (Latin characters)
          - `state` string — Transliterated state/province (Latin characters)
  - `countryCode` string — Country code (ISO 3166-1 alpha-2)
  - `email` string — Email address
  - `phone` string — Phone number
  - `address` AddressDto
    - `addressLine1` string, required — Address line 1
    - `addressLine2` string — Address line 2 (apartment, suite, etc.)
    - `city` string, required — City
    - `state` string — State / Province
    - `postalCode` string, required — Postal code / ZIP code. May be empty for countries without a postal-code system, including the United Arab Emirates.
    - `country` string, required — Country code (ISO 3166-2)
    - `transliterated` TransliteratedAddressDto
      - `addressLine1` string — Transliterated address line 1 (Latin characters)
      - `addressLine2` string — Transliterated address line 2 (Latin characters)
      - `city` string — Transliterated city (Latin characters)
      - `state` string — Transliterated state/province (Latin characters)
  - `hasOwnership` boolean, required — Whether this entity is an owner. For an individual with indirect ownership whose percentage is not quantified, set this to true to identify them as a beneficial owner.
  - `hasControl` boolean, required — Has significant control
  - `ownershipPercentage` number — Ownership percentage
  - `isSigner` boolean — Has signing authority
  - `isDirector` boolean — Is a director
  - `role` 'CEO' | 'CFO' | 'COO' | 'PRESIDENT' | 'GENERAL_COUNSEL' | 'MANAGING_MEMBER' | 'TREASURER' | 'OTHER' — Structured role at the company.
  - `title` string — Custom title at the company.
  - `documents` string[] — Array of document IDs
  - `attestedOwnershipStructureAt` string — Timestamp when ownership structure was attested
  - `displayName` string — Display name
  - `verificationLink` VerificationLinkDto
    - `sessionId` string, required — Verification session ID
    - `verificationUrl` string, required — URL for the UBO to complete their verification
    - `expiresAt` string, required — When the verification link expires
    - `status` 'PENDING' | 'ACTIVE' | 'IN_PROGRESS' | 'COMPLETED' | 'EXPIRED' | 'CANCELLED' | 'SUBMITTED', required — Current status of the verification session

## Other responses

- `401` — Unauthorized - Invalid or missing authentication credentials
- `403` — Customer belongs to a different organization
- `404` — Associated entity or customer not found

---

[API](https://skmtc.dev/infinite/apis/infinite-api.md) · [All operations](https://skmtc.dev/infinite/apis/infinite-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infinite/infinite-api/revisions/7d6487f295d7/schema)