Required Details

Key

Value	Description
✅	Required field
🟡	Best effort optional field (providing details here ensures less friction during onboarding)
—	Not applicable

Required Person Details

The required details for persons being onboarded as Identities depend on the licensing arrangement and solution. See the table below:

Field	Paxos Trust Company Licensing (Crypto Brokerage)
`first_name`	✅
`last_name`	✅
`date_of_birth`	✅
`address`	✅
`nationality`	✅
`cip_id`	✅
`cip_id_type`	✅
`cip_id_country`	✅
`cdd.estimated_yearly_income`	✅
`cdd.expected_transfer_value`	✅
`cdd.source_of_wealth`	✅
`cdd.employment_status`	✅
`cdd.employment_industry_sector`	✅
`middle_name`	🟡
`phone_number`	🟡
`email`	🟡
`profession`	—
`country_of_birth`	—
`cdd.aliases`	—
`cdd.estimated_net_worth`	—
`cdd.customer_regions`	—
`cdd.source_of_funds`	—
`cdd.purpose_of_account`	—

Required Institution Details

Institution identities are used to represent all non-person entities. Details for institution identity type are recorded in institution_details. An institution identity also has institution_members associated with it. These define persons that have some relationship to the institution.

Required Fields for Institution Types

The required fields for institutions being onboarded as Identities depend on the institution type. See the table below:

Field	Trust	Corporation, LLC, Partnership	Registered Investment Advisor (RIA)
`name`	✅	✅	✅
`business_address`	✅	✅	✅
`phone_number`	🟡	🟡	🟡
`email`	🟡	🟡	🟡
`institution_type`	✅	✅	✅
`institution_sub_type`	✅	✅	✅
`cip_id`	✅	✅	✅
`cip_id_type`	✅	✅	✅
`cip_id_country`	✅	✅	✅
`govt_registration_date`	✅	✅	✅
`incorporation_address`	🟡	✅	✅
`regulation_status`	🟡	✅	✅
`trading_type`	🟡	✅	✅
`listed_exchange`	🟡	Depends on regulation status	Depends on regulation status
`ticker_symbol`	🟡	Depends on regulation status	Depends on regulation status
`parent_institution_name`	🟡	Depends on regulation status	Depends on regulation status
`regulator_name`	🟡	Depends on regulation status	Depends on regulation status
`regulator_jurisdiction`	🟡	Depends on regulation status	Depends on regulation status
`regulator_register_number`	🟡	Depends on regulation status	Depends on regulation status
`doing_business_as`	🟡	🟡	🟡
`business_description`	🟡	✅	🟡
`tax_details`	Auto-populated if cip_id_type is SSN, ITIN or EIN	Auto-populated if cip_id_type is SSN, ITIN or EIN	Auto-populated if cip_id_type is SSN, ITIN or EIN
`tax_details_not_required`	Can be set for non-US institutions	Can be set for non-US institutions	Can be set for non-US institutions
`metadata`	🟡	🟡	🟡
`ref_id`	🟡	🟡	🟡
`cdd.aliases`	🟡	🟡	🟡
`cdd.source_of_wealth`	🟡	✅	🟡
`cdd.source_of_funds`	🟡	✅	🟡
`cdd.industry_sector`	🟡	✅	🟡
`cdd.has_underlying_trust_structure`	🟡	✅	🟡
`cdd.has_nominee_shareholders`	🟡	✅	🟡
`cdd.is_publicly_traded`	🟡	🟡	🟡
`cdd.merchant_funding_source`	Only for payments integrations	Only for payments integrations	Only for payments integrations
`cdd.customer_regions`	Only for payments integrations	Only for payments integrations	Only for payments integrations

Notes:

For Trusts: institution_type must be set to TRUST. institution_sub_type must be set to INVESTMENT. incorporation_address is required for Trusts where their cip_id_type is not SSN or ITIN.
For RIAs: Usage of this sub-type requires prior authorization and approval from Paxos. institution_sub_type must be set to REGISTERED_INVESTMENT_ADVISOR.
For regulation_status: Additional validations are tied to trading_type and other required fields. See Institution Types and Members for details.

For more information about institution types, member roles and requirements, please refer to Institution Types and Members.

Get Started

Identity

Stablecoin Operations

Fiat Transfers

Stablecoin Payments

Settlements

Crypto Brokerage

Webhooks

Additional Guides

Versioning

Key

Required Person Details

Required Institution Details

Required Fields for Institution Types

​Key

​Required Person Details

​Required Institution Details

​Required Fields for Institution Types

Key

Required Person Details

Required Institution Details

Required Fields for Institution Types