---
title: "Update an associated business"
method: PATCH
path: "/v1/customers/{customerId}/associated_businesses/{id}"
tags: ["Customers"]
---

# Update an associated business

`PATCH /v1/customers/{customerId}/associated_businesses/{id}`

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

## Path parameters

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

## Headers

- `X-API-Key` string

## Request body

- UpdateAssociatedBusinessDto
  - `parentEntityId` string, nullable — Parent entity ID for nested ownership. Must reference a BUSINESS associated entity on the same customer.
  - `countryCode` string — Country code (ISO 3166-1 alpha-2)
  - `email` string, email — 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 — 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 — 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.
  - `supportingDocuments` DocumentUploadDto[] — Additional supporting document references for this associated entity.
    - `requirementId` string — Stable identifier for the custom document requirement this upload satisfies
    - `type` 'IDENTITY' | 'PROOF_OF_ADDRESS' | 'INVOICE' | 'CONTRACT' | 'BANK_STATEMENT' | 'BUSINESS_LICENSE' | 'ARTICLES_OF_INCORPORATION' | 'ARTICLES_OF_ASSOCIATION' | 'CERTIFICATE_OF_FORMATION' | 'CERTIFICATE_OF_INCUMBENCY' | 'OPERATING_AGREEMENT' | 'PARTNERSHIP_AGREEMENT' | 'OWNERSHIP_STRUCTURE' | 'SHAREHOLDER_AGREEMENT' | 'STOCK_CERTIFICATE' | 'TAX_RETURN' | 'FINANCIAL_STATEMENT' | 'MARKETING_MATERIALS' | 'DOMAIN_OWNERSHIP_PROOF' | 'BUSINESS_PLAN' | 'BILL_OF_LADING' | 'AML_POLICY' | 'AML_COMFORT_LETTER' | 'FUNDS_FLOW_DIAGRAM' | 'GOOD_STANDING_CERTIFICATE' | 'TIN_VERIFICATION' | 'MSB_LICENSE' | 'DIRECTORS_REGISTRY' | 'OWNERSHIP_CHART' | 'PROOF_OF_SIGNATORY_AUTHORITY' | 'PROOF_OF_SOURCE_OF_FUNDS' | 'PROOF_OF_ENTITY_NAME_CHANGE' | 'REMOTE_ADDRESS_ATTESTATION' | 'E_SIGNATURE_CERTIFICATE' | 'COMPLIANCE_NOTES' | 'PROOF_OF_SOURCE_OF_WEALTH' | 'TAX_EXEMPT_ENTITY_CONFIRMATION' | 'OTHER' — General document category. Optional for context-specific uploads where the field already implies the document type.
    - `subtype` 'GOVERNMENT_ID_FRONT' | 'GOVERNMENT_ID_BACK' | 'SELFIE' | 'UTILITY_BILL' | 'LEASE_AGREEMENT' — Specific document type. Optional for generic uploads when the subtype is not material to processing.
    - `description` string — Description of the document
    - `remarks` string — Free-form remarks or notes about the document
    - `file` string, required — Document ID reference (`doc_xxx`) created via the document upload flow. Upload the file with `POST /documents`, confirm it, then pass the resulting document ID here.
  - `attestedOwnershipStructureAt` string — Timestamp when ownership structure was attested
  - `relationshipDate` string — Date when the relationship with this entity was established (YYYY-MM-DD)
  - `businessName` string — Business name
  - `registrationNumber` string — Business registration number
  - `dateOfIncorporation` string — Date of incorporation (YYYY-MM-DD)
  - `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)

## Response `200`

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

---

[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/382abbca8b01/schema)