Sign in
Customers

Update an associated individual

Update an individual associated entity for a customer without sending polymorphic nested detail objects.

patch/v1/customers/{customerId}/associated_individuals/{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

Request body

parentEntityIdstring nullable

Parent entity ID for nested ownership. Must reference a BUSINESS associated entity on the same customer.

countryCodestring

Country code (ISO 3166-1 alpha-2)

emailstring email

Email address

phonestring

Phone number

hasOwnershipboolean

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

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.

attestedOwnershipStructureAtstring

Timestamp when ownership structure was attested

relationshipDatestring

Date when the relationship with this entity was established (YYYY-MM-DD)

firstNamestring

First name

lastNamestring

Last name

middleNamestring

Middle name

nicknamestring

Nickname

dateOfBirthstring

Date of birth (YYYY-MM-DD)

taxIdentificationNumberstring

Tax identification number. Validated in the service against the stored nationality and residence, so partial updates that omit countries are still checked.

taxIdentificationDocumentTypestring

Tax identification document type when the issuing country supports multiple tax ID types.

transliteratedFirstNamestring

Transliterated first name

transliteratedMiddleNamestring

Transliterated middle name

transliteratedLastNamestring

Transliterated last name

Example request

{
  "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"
    }
  },
  "governmentId": {
    "type": "PASSPORT",
    "countryCode": "US",
    "number": "A12345678",
    "issuanceDate": "2020-01-15",
    "expirationDate": "2030-01-15",
    "frontImage": "doc_abc123"
  },
  "proofOfAddress": {
    "type": "UTILITY_BILL",
    "countryCode": "US",
    "issueDate": "2026-10-01",
    "file": "doc_abc123"
  },
  "supportingDocuments": [
    {
      "type": "PROOF_OF_ADDRESS",
      "subtype": "UTILITY_BILL",
      "description": "Passport issued in 2020",
      "remarks": "Uploaded to support proof of business address",
      "file": "doc_abc123"
    }
  ],
  "relationshipDate": "2020-01-15",
  "taxIdentificationDocumentType": "UTR"
}

Response

Associated individual updated 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 1 revision of this API.