Sign in
Customers

Update an associated business

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

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

businessNamestring

Business name

registrationNumberstring

Business registration number

dateOfIncorporationstring

Date of incorporation (YYYY-MM-DD)

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"
    }
  },
  "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",
  "businessAddress": {
    "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"
    }
  }
}

Response

Associated business 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.