Create End User Account
Last updated
Last updated
POST
https://api.sfox.com/v1/enterprise/register-account
Create (register) an sFOX account for an end user.
Creating an account is the first step in the end user onboarding flow. In this request, you will provide identification information for your user, whether that user is an individual or a business. sFOX will then register an account on behalf of this end user.
Collect this information from the end user within your platform and submit it to sFOX. Refer to this example onboarding flow in .
account_type required
string
Type of sFOX account to create.
Possible values: individual, corporation
account_role required
string
The primary role of this account.
Possible values: client, advisor
user_id required
string
Unique ID for this user defined by you that will serve as the shared identifier for this account between you and sFOX
advisor_user_id
string
The user_id of an existing account with account_role = advisor, if applicable. Defining the advisor_user_id for an account ties this account to the advisor account.
email required
string
User's email address.
first_name required
string
User's first name.
last_name required
string
User's last name.
phone_country_code required
string
Country code of the user's phone number.
Must be a valid 2 character country code.
e.g. If the user's phone_number is a United States (US) phone number then phone_country_code should = US.
phone_number required
string
account_purpose required
string
Primary purpose or use case for the account.
Possible values for account_type = individual : Trading, Selling only, Other, Online purchases, Online payments, Investing, Buying only, Business
Possible values for account_type = corporation : Treasury Management, Operating, Liquidating Crypto Assets, Investment Fund, Cross Border Payments, Arbitrage Trading, Other
individual
Required if account_type = individual. Include the following parameters in individual[]
business
Required if account_type = corporation . Include the following parameters in business[]
beneficial_owners
Required if account_type = corporation . Include the following parameters in beneficial_owners[]
dob required
string
User's date of birth
residential_country_code required
string
User's country of residence e.g. US
residential_address required
string
User's street address of primary residence
residential_city required
string
City of primary residence
residential_state required
string
State or province of primary residence. If residential_country_code = US, must be a valid 2 char state code e.g. CA
id_type required
string
Form of identification associated with the id_number below. If residential_country_code <> US, must be passport. Else, passport or ssn
id_number required
string
Social Security Number or Passport Number of the user’s identification.
id_country_code required
string
Issuing country of the identification. If id_type = ssn, must be US
entity_name required
string
The legal business entity name
incorporation_country required
string
Country code the entity was incorporated
incorporation_state required
string
State the entity was incorporated
incorporation_date required
string
Date that the company was created
organization_type required
string
The type of business organization.
Possible values: Trust, Sole Proprietor, LLC, Partnership, Corporation, Other
business_type required
string
The type of business this entity conducts.
Possible values: Hedge Fund, Private Equity Fund, Mutual Fund, Proprietary Trading Firm, Personal Investment Company, Individual Retirement Account Holding Company, Money Service Business (MSB), Financial Institution Brokerage, Agency OTC Brokerage, Principle OTC Brokerage, Retail Brokerage, Robo-Advisor, or FX/CFD Provider, Fund of Funds, Pension Fund, Endowment, Exchange Traded Fund, Fund Administrator, Professional Service Provider (Accounting or Law Firm), Software Vendor, Platform Provider, Data Aggregator, Charity Organization or Non-profit, Crypto Exchange, Digital Currency Mining Firm, Merchant
registration_number required
string
The business’s TIN (tax identification number) for US businesses or registration number
website
string
URL to the business’s website
description required
string
A description of the business
accredited_investor required
string
Whether the business has accredited investor status
non_agent_intermediary required
string
Whether the business has is acting as a non-agent intermediary
principal_place_country required
string
Country code of the business’ principal place of business operations
principal_place_state required
string
State/province of the business’ principal place of business operations
principal_place_address required
string
Street address of the business’ principal place of business operations
principal_place_city required
string
City of the business’ principal place of business operations
postal_code required
string
Postal code of the business’ principal place of business operations
first_name required
string
The first name of the beneficial owner
middle_name
string
The middle name of the beneficial owner
last_name required
string
The last name of the beneficial owner
email required
string
The email address of beneficial owner
phone_number required
string
The phone number of beneficial owner
dob required
string
The date of birth of beneficial owner
residential_country_code required
string
User's country of residence e.g. US
residential_address required
string
User's street address of primary residence
residential_city required
string
City of primary residence
residential_state required
string
State or province of primary residence. If residential_country_code = US, must be a valid 2 char state code e.g. CA
id_type required
string
Form of identification associated with the id_number below. If residential_country_code <> US, must be passport. Else, passport or ssn
id_number required
string
Social Security Number or Passport Number of the user’s identification
id_country_code required
string
Issuing country of the identification. If id_type = ssn, must be US
user_id
The shared unique identifier for the account as defined by you in the request
status
The verification status of the account
Unsupported
Pending
Verified
requirements
The remaining requirements to complete account verification
The user's phone number in :
<+><1-3 digit numerical country code><phone number including area code>
e.g. +14155552671
Object of
Object of
Array of objects