The Individual Investor Profile within the Parties API enables developers to onboard and manage profiles for individual investors. This document provides an organized breakdown of attributes for the individual investor profile.

Personal Information

Attribute	Type	Description
first_name	string	Given name.
middle_name	string (optional)	Middle name or initial.
last_name	string	Surname.
salutation	string (optional)	Salutation or title (e.g., "mr", "ms").
primary_phone	string	Primary contact phone number.
primary_email	string	Primary contact email (should be unique).
addresses	array of objects	Address details (see below).

`addresses`

Attribute	Type	Description
address_type	string	Type of address (e.g., "primary").
address_line_1	string	First address line.
address_line_2	string (optional)	Second address line.
address_line_3	string (optional)	Third address line.
city	string	City name.
region	string	State or region name.
postal_code	string	Postal or ZIP code.
country	string	Country code.
attention_of	string (optional)	Attention to specific entity/person.

{
  "id": "9861f309-6349-4491-afd3-43651c2f0c5e",
  "party_type": "individual",
  "individual": {
    "first_name": "John",
    "middle_name": "Roe",
    "last_name": "Doe",
    "salutation": "mr",
    "primary_phone": "+13124012433",
    "primary_email": "[email protected]",
    "addresses": [
      {
        "id": "0e2ec4bf-407b-413d-af7a-9f4ae4eaa830",
        "address_type": "primary",
        "attention_of": null,
        "address_line_1": "111 NE 2nd Ave",
        "address_line_2": null,
        "address_line_3": null,
        "city": "Miami",
        "region": "FL",
        "postal_code": "33132",
        "country": "US",
        "created_at": "2023-08-31T03:19:55.200006Z",
        "updated_at": "2023-08-31T03:19:55.200712Z",
        "metadata": {}
      }
    ]
    ...
  }
  ...
}

Identity Verification

Attribute	Type	Description
date_of_birth	string	Date of birth (`YYYY-MM-DD` format).
country_of_residence	string	Current country of residence.
region_of_residence	string	State or region of residence.
citizenship	array of strings	Countries of citizenship.
national_id	object	Details about national ID (see below).
documents	array of documents	Identity verification documents: - National Id - Passport - Drivers License *all international investors require passport uploaded

`national_id`

Attribute	Type	Description
issuing_country	string	Country that issued the ID.
type	string	Type of national ID.
value	string	National ID value.

{
  "id": "9861f309-6349-4491-afd3-43651c2f0c5e",
  "party_type": "individual",
  "individual": {
    "date_of_birth": "1990-09-21",
    "country_of_residence": "US",
    "region_of_residence": "FL",
    "citizenship": [
      "US",
      "IN"
    ],
    "national_id": {
      "issuing_country": "US",
      "type": "ssn",
      "value": "773995678"
    },
    "documents": [
      {
        "id": "dc6fb149-0cc7-4e16-a89f-4b00e24310f7",
        "name": "John Doe Passport",
        "description": null,
        "purpose": "identity",
        "document_type": "passport",
        "document_subtype": null,
        "party_id": "9861f309-6349-4491-afd3-43651c2f0c5e",
        "file_url": "https://storage.googleapis.com/",
        "metadata": {}
      }
    ]
    ...
  }
  ...
}

Accredited Verification

Attribute	Type	Description
accredited_investor_type	string (optional)	Type of accredited investor.
documents	array of documents	Accredited verification documents: - Payroll Documents(2 years) - Tax Returns(2 years) - Assets and Liability Statements - SEC License - Certification Letter from CPA, RIA

{
  "id": "9861f309-6349-4491-afd3-43651c2f0c5e",
  "party_type": "individual",
  "individual": {
    "id": "9861f309-6349-4491-afd3-43651c2f0c5e",
    "accredited_investor_type": "annual_income_over_threshold",
    "documents": [
      {
        "id": "237ce40b-b72d-4954-8fc9-6c6a3f6bb79b",
        "name": "John Doe 2 Year Tax Return",
        "description": null,
        "purpose": "accreditation",
        "document_type": "tax_form",
        "document_subtype": null,
        "party_id": "9861f309-6349-4491-afd3-43651c2f0c5e",
        "file_url": "https://storage.googleapis.com/",
        "metadata": {}
      }
    ]
    ...
  }
  ...
}

Tax Residency

Attribute	Type	Description
residencies	array of objects	List of tax residencies (see nested details).
us_person	boolean	If the individual is a U.S. person for tax.

`residencies`

Attribute	Type	Description
primary	boolean	If it's the primary residency.
country	string	Country code.
tin_type	string	Type of tax identification number.
tin_value	string	Actual tax identification number.
reason_tin_not_provided	string (optional)	Reason for not providing TIN.

{
  "id": "9861f309-6349-4491-afd3-43651c2f0c5e",
  "party_type": "individual",
  "individual": {
    "id": "9861f309-6349-4491-afd3-43651c2f0c5e",
    "tax_residency": {
      "residencies": [
        {
          "primary": true,
          "country": "US",
          "tin_type": "ssn",
          "tin_value": "773995678",
          "reason_tin_not_provided": null
        },
        {
          "primary": false,
          "country": "IN",
          "tin_type": "adhar",
          "tin_value": "1234/12345/12345",
          "reason_tin_not_provided": null
        }
      ],
      "date_of_declaration": "2023-08-31T03:52:50.013790Z",
      "us_person": true
    }
    ...
  }
  ...
}

Payment Method

Attribute	Type	Description
id	string	Unique identifier for the record.
party_id	string	Unique identifier for the associated party.
account_type	string	Type of account (e.g., "checking").
account_holder_address	object	Contains details about the billing address of the account holder.
name	string	Name associated with the account (e.g., "John Doe Checking").
bank_name	string	Name of the bank (e.g., "JP Morgan Chase").
bank_country	string	Country where the bank is located (e.g., "US").
account_number	string	Bank account number.
bank_identification_codes	object	Contains bank-specific codes like IBAN, SWIFT/BIC, etc.
payment_type	string	Type of payment (e.g., "wire").

`account_holder_address`

Attribute	Type	Description
address_type	string	Type of address (e.g., "primary").
address_line_1	string	First address line.
address_line_2	string (optional)	Second address line.
address_line_3	string (optional)	Third address line.
city	string	City name.
region	string	State or region name.
postal_code	string	Postal or ZIP code.
country	string	Country code.
attention_of	string (optional)	Attention to specific entity/person.

`bank_identification_codes`

Attribute	Type	Description
iban	string	International Bank Account Number (optional).
swift_bic	string	Bank Identifier Code (optional).
routing_number	string	Routing number, specific to some banks (e.g., in the USA).
sort_code	string	Sort code, often used in UK banking (optional).

{
  "id": "d67331cc-2f8d-44c1-8f23-8cd15b35b10f",
  "party_type": "individual",
  "individual": {
    "payment_methods": [
    	{
        "id": "c4f8aa11-c3bd-4d89-8244-5f2816e9abf3",
        "party_id": "d67331cc-2f8d-44c1-8f23-8cd15b35b10f",
        "account_type": "checking",
        "account_holder_address": {
          "id": "3841f98b-67f9-45e2-9688-0828a1083f64",
          "address_type": "legal",
          "attention_of": null,
          "address_line_1": "111 NE 2nd Ave",
          "address_line_2": null,
          "address_line_3": null,
          "city": "Miami",
          "region": "FL",
          "postal_code": "33132",
          "country": "US",
          "created_at": "2023-09-05T17:00:05.489560Z",
          "updated_at": "2023-09-05T17:00:05.490185Z",
          "metadata": {}
        },
        "name": "John Doe Checking",
        "bank_name": "JP Morgan Chase",
        "bank_country": "US",
        "account_number": "00011345678",
        "bank_identification_codes": {
          "iban": "",
          "swift_bic": "",
          "routing_number": "071000013",
          "sort_code": ""
        },
        "payment_type": "wire"
      }
    ]
    ...
  }
  ...
}