Sign in
Customers

Get an associated entity by id and customer

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

get/v1/customers/{customerId}/associated_entities/{id}

Path parameters

customerIdstring required
Example:cus_1234567890abcdef

An ID that uniquely identifies a customer resource

idstring required
Example:asp_1234567890abcdef

An ID that uniquely identifies an associated entity resource

Headers

X-API-Keystring

API key

Response

Associated entity details retrieved successfully

idstring required

Unique identifier

createdAtstring required

Created timestamp

updatedAtstring required

Last updated timestamp

entityType'INDIVIDUAL' | 'BUSINESS' required

Type of entity

parentEntityIdstring

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.

countryCodestring

Country code (ISO 3166-1 alpha-2)

emailstring

Email address

phonestring

Phone number

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

hasControlboolean required

Has significant control

ownershipPercentagenumber

Ownership percentage

isSignerboolean

Has signing authority

isDirectorboolean

Is a director

role'CEO' | 'CFO' | 'COO' | 'PRESIDENT' | 'GENERAL_COUNSEL' | 'MANAGING_MEMBER' | 'TREASURER' | 'OTHER'

Structured role at the company.

titlestring

Custom title at the company.

documentsstring[]

Array of document IDs

attestedOwnershipStructureAtstring

Timestamp when ownership structure was attested

displayNamestring

Display name

Example response

{
  "id": "asp_abc123",
  "createdAt": "2026-01-15T10:30:00Z",
  "updatedAt": "2026-01-15T10:30:00Z",
  "entityType": "BUSINESS",
  "parentEntityId": "asp_parent123",
  "details": {
    "firstName": "John",
    "nickname": "Johnny",
    "lastName": "Doe",
    "middleName": "Michael",
    "dateOfBirth": "1985-03-15",
    "taxIdentificationDocumentType": "UTR"
  },
  "countryCode": "US",
  "email": "contact@acmeholdings.com",
  "phone": "+14155551234",
  "address": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Apt 4B",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94102",
    "country": "US",
    "transliterated": {
      "addressLine1": "123 Main Street",
      "addressLine2": "Apt 4B",
      "city": "Beijing",
      "state": "Hebei"
    }
  },
  "hasOwnership": true,
  "hasControl": true,
  "ownershipPercentage": 51,
  "title": "Managing Director",
  "documents": [
    "doc_abc123"
  ],
  "attestedOwnershipStructureAt": "2026-01-15T10:30:00Z",
  "displayName": "Acme Holdings LLC",
  "verificationLink": {
    "sessionId": "vsess_abc123",
    "verificationUrl": "https://verify.infinite.dev/?sessionId=vsess_abc123",
    "expiresAt": "2026-01-09T10:30:00Z",
    "status": "ACTIVE"
  }
}

Changes

No recorded changes to this endpoint across all 4 revisions of this API.