Affiliation

The Affiliation payload records the account holder's Affiliation details. Affiliation in account onboarding refers to the applicant’s connections with public companies, industries, political entities, or specific organizations. This information is vital for risk assessment and compliance, enabling KYC and AML checks to detect high-risk affiliations like PEPs (politically exposed persons) or industry restrictions while ensuring regulatory adherence. The affiliation information block is optional but must adhere to the defined validations.

Payload Structure with Validation Rules

Schema

Field Name	Type	Description	Validations	Values Accepted
publicCompany	Boolean	Indicates whether the account holder is affiliated with a publicCompany.	Must be "true", "false" or empty.	true, false, or (empty)
industry	Boolean	Indicates whether the account holder is affiliated with a industry.	Must be "true", "false" or empty.	true, false, or (empty)
political	Boolean	Indicates whether the account holder is affiliated with a political.	Must be "true", "false" or empty.	true, false, or (empty)
relationship	String	Account holder's relationship to the affiliation.	Required if any affiliation (publicCompany, industry, political) is true; otherwise, must be empty.	Child, Self, Spouse, Other.
name	String	Firm's or employer's name for the affiliation response.	Required if any affiliation (publicCompany, industry, political) is true; otherwise, must be empty. Max 40 characters.	a-Z, 0-9, #, /
organization	String	Affiliated organization (publicCompany, industry, political).	Required if any affiliation (publicCompany, industry, political) is true; otherwise, must be empty. Max 40 characters.	a-Z, 0-9, #, /
country	String	Firm's or employer's country for the affiliation response.	Required if political affiliation is true; else empty.	Countries
street	String	Street address of the firm or employer.	political status being true requires a country value. Max 160 characters.	a-Z, 0-9, #, /
city	String	City of the firm or employer.	political status being true requires a city value. Max 20 characters.	a-Z, #, /
stateProvince	String	State or province of the firm or employer.	political status being true requires a valid 2-character US stateProvince code.	US States
postalCode	String	Postal code or ZIP code of the firm or employer.	political status being true requires a valid 5-digit US ZIP code.	Exact 5 digits

Example

{....
  "primaryOwner": { ....
    "affiliation": {
      "publicCompany": "true",
      "industry": "true",
      "political": "true",
      "relationship": "Self",
      "name": "Hanks International",
      "organization": "Tim Cook",
      "address": {
        "country": "US",
        "street": "Tory Pines",
        "city": "Sandiago",
        "stateProvince": "CA",
        "postalCode": "35243"
      }
    }
  }
}

Any validation failure will trigger an error message and halt the Account Creation or Updation Process.

Error Scenarios

For any validation failures, refer Standard Errors and Account Related Errors.