Customers

Create a new associated individual

Create an individual associated entity for a business customer using a flat request body. Use this endpoint for UBOs, control persons, and signers.

post/v1/customers/{customerId}/associated_individuals

Path parameters

customerIdstring required

Example:cus_1234567890abcdef

An ID that uniquely identifies a customer resource

Headers

X-API-Keystring

API key

Idempotency-Keystring

Idempotency key for preventing duplicate requests

Request body

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.

countryCode'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BR' | 'BS' | 'BT' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'EU' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' required

Country code (ISO 3166-1 alpha-2). Nationality for individuals, country of incorporation for businesses.

emailstring email

Email address. Required when generateVerificationLink is true.

phonestring

Phone number

hasOwnershipboolean required

Whether this entity is an owner. For an individual with indirect ownership whose percentage is not quantified, omit ownershipPercentage and set this to true to identify them as a beneficial owner.

hasControlboolean required

Has significant control (e.g. CEO, managing member). A control person satisfies the business submission requirement when no individual holds 25% or more effective ownership.

ownershipPercentagenumber

Ownership percentage

isSignerboolean

Has signing authority

isDirectorboolean

Is a director

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

generateVerificationLinkboolean

When true, generates a verification link for this UBO to complete their KYC. The link will be returned in the response.

sendInviteboolean

When true (and generateVerificationLink is also true), sends an email invitation to the UBO to complete their KYC verification.

firstNamestring required

First name

lastNamestring required

Last name

middleNamestring

Middle name

nicknamestring

Nickname

dateOfBirthstring

Date of birth (YYYY-MM-DD)

taxResidenceCountrystring

Optional. Country of tax residence (ISO 3166-1 alpha-2). Provide only when it differs from nationality; tax ID format validation falls back to nationality when omitted.

taxIdentificationNumberstring

Tax identification number. Validated against country-specific formats when provided.

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

{
  "parentEntityId": "asp_abc123",
  "countryCode": "US",
  "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"
    }
  },
  "attestedOwnershipStructureAt": "2026-06-01T10:45:05Z",
  "relationshipDate": "2020-01-15",
  "generateVerificationLink": true,
  "sendInvite": true,
  "firstName": "John",
  "lastName": "Doe",
  "dateOfBirth": "1990-01-15",
  "taxResidenceCountry": "GB",
  "taxIdentificationDocumentType": "UTR",
  "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"
    }
  ]
}

Response

Associated individual created 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, omit ownershipPercentage and set this to true to identify them as a beneficial owner.

hasControlboolean required

Has significant control (e.g. CEO, managing member). A control person satisfies the business submission requirement when no individual holds 25% or more effective ownership.

ownershipPercentagenumber

Ownership percentage

isSignerboolean

Has signing authority

isDirectorboolean

Is a director

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",
    "taxResidenceCountry": "GB",
    "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

Changed in 2 of the 19 revisions of this API.3

Sep 20, 20267788dddbcb212See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property ///// to the response with the status
  response-optional-property-added
Sep 5, 202670223aefae8c1See the full diff
- ○
  added the new LIVENESS_CHECK enum value to the request property //
  request-property-enum-value-added

Full history