Send the investor's suitability

curl --request POST \
  --url https://partners-api.sandbox.securitize.io/investors/v1/onboarding-reliance/investors/{investorId}/suitability \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "isLicensedSecuritiesProfessional": false,
  "isAffiliatedWithSecuritiesFirm": false,
  "educationLevel": "higher_education",
  "annualIncome": "100k_to_250k",
  "netWorth": "500k_to_1m",
  "investablePercentageOfNetWorth": "10_to_25",
  "investmentApproach": "aggressive_growth",
  "investmentHorizon": "3_to_5_years",
  "lossTolerance": "over_30_percent",
  "acceptsIlliquidity": true,
  "occupation": "employee",
  "declaresLawfulOriginOfFunds": true,
  "isPoliticallyExposedPerson": false,
  "assetExperience": {
    "equities": {
      "experience": "some",
      "knowledge": "some",
      "tradingFrequency": "occasionally"
    },
    "fixedIncome": {
      "experience": "some",
      "knowledge": "some",
      "tradingFrequency": "occasionally"
    },
    "collectiveInvestment": {
      "experience": "some",
      "knowledge": "some",
      "tradingFrequency": "occasionally"
    },
    "optionsAndDerivatives": {
      "experience": "none",
      "knowledge": "none",
      "tradingFrequency": "never"
    },
    "digitalAssets": {
      "experience": "some",
      "knowledge": "some",
      "tradingFrequency": "occasionally"
    },
    "privatePlacements": {
      "experience": "none",
      "knowledge": "some",
      "tradingFrequency": "never"
    },
    "realEstate": {
      "experience": "none",
      "knowledge": "some",
      "tradingFrequency": "never"
    }
  },
  "declarations": {
    "subscriberAgreementReviewed": true,
    "formCrsReviewed": true,
    "affirmationsConfirmed": true
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    isLicensedSecuritiesProfessional: false,
    isAffiliatedWithSecuritiesFirm: false,
    educationLevel: 'higher_education',
    annualIncome: '100k_to_250k',
    netWorth: '500k_to_1m',
    investablePercentageOfNetWorth: '10_to_25',
    investmentApproach: 'aggressive_growth',
    investmentHorizon: '3_to_5_years',
    lossTolerance: 'over_30_percent',
    acceptsIlliquidity: true,
    occupation: 'employee',
    declaresLawfulOriginOfFunds: true,
    isPoliticallyExposedPerson: false,
    assetExperience: {
      equities: {experience: 'some', knowledge: 'some', tradingFrequency: 'occasionally'},
      fixedIncome: {experience: 'some', knowledge: 'some', tradingFrequency: 'occasionally'},
      collectiveInvestment: {experience: 'some', knowledge: 'some', tradingFrequency: 'occasionally'},
      optionsAndDerivatives: {experience: 'none', knowledge: 'none', tradingFrequency: 'never'},
      digitalAssets: {experience: 'some', knowledge: 'some', tradingFrequency: 'occasionally'},
      privatePlacements: {experience: 'none', knowledge: 'some', tradingFrequency: 'never'},
      realEstate: {experience: 'none', knowledge: 'some', tradingFrequency: 'never'}
    },
    declarations: {
      subscriberAgreementReviewed: true,
      formCrsReviewed: true,
      affirmationsConfirmed: true
    }
  })
};

fetch('https://partners-api.sandbox.securitize.io/investors/v1/onboarding-reliance/investors/{investorId}/suitability', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://partners-api.sandbox.securitize.io/investors/v1/onboarding-reliance/investors/{investorId}/suitability"

payload = {
    "isLicensedSecuritiesProfessional": False,
    "isAffiliatedWithSecuritiesFirm": False,
    "educationLevel": "higher_education",
    "annualIncome": "100k_to_250k",
    "netWorth": "500k_to_1m",
    "investablePercentageOfNetWorth": "10_to_25",
    "investmentApproach": "aggressive_growth",
    "investmentHorizon": "3_to_5_years",
    "lossTolerance": "over_30_percent",
    "acceptsIlliquidity": True,
    "occupation": "employee",
    "declaresLawfulOriginOfFunds": True,
    "isPoliticallyExposedPerson": False,
    "assetExperience": {
        "equities": {
            "experience": "some",
            "knowledge": "some",
            "tradingFrequency": "occasionally"
        },
        "fixedIncome": {
            "experience": "some",
            "knowledge": "some",
            "tradingFrequency": "occasionally"
        },
        "collectiveInvestment": {
            "experience": "some",
            "knowledge": "some",
            "tradingFrequency": "occasionally"
        },
        "optionsAndDerivatives": {
            "experience": "none",
            "knowledge": "none",
            "tradingFrequency": "never"
        },
        "digitalAssets": {
            "experience": "some",
            "knowledge": "some",
            "tradingFrequency": "occasionally"
        },
        "privatePlacements": {
            "experience": "none",
            "knowledge": "some",
            "tradingFrequency": "never"
        },
        "realEstate": {
            "experience": "none",
            "knowledge": "some",
            "tradingFrequency": "never"
        }
    },
    "declarations": {
        "subscriberAgreementReviewed": True,
        "formCrsReviewed": True,
        "affirmationsConfirmed": True
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "status": "completed",
  "verificationStatus": "verified"
}

Suitability and DLT test

Send the investor's suitability

Records the investor’s suitability — Securitize’s investor profile: experience, finances, risk profile, experience per asset class, and your attestation that the investor reviewed Securitize’s documents — in one call, and answers the verdict in the same response. The same questionnaire serves individuals and entities, and it can be sent at any investor status. An investor you have limited access to can be sent too.

One suitability per investor, and it cannot be changed. The first complete submission — yours, another partner’s or the investor’s own on Securitize — is final. A later call writes nothing and answers 200 with the current state.

Read verificationStatus, not status. status says whether the questionnaire is completed; verificationStatus is Securitize’s verdict, the one that token whitelisting requires.

For an individual, the answers decide the verdict in the same response:

verified — investmentApproach is aggressive_growth, lossTolerance is over_30_percent, acceptsIlliquidity is true, and both isLicensedSecuritiesProfessional and isAffiliatedWithSecuritiesFirm are false. Once the investor’s own status (GET /investors/{investorId}) is verified, their Securitize Markets brokerage account is approved too.
rejected — investmentApproach is not aggressive_growth, lossTolerance is not over_30_percent, or acceptsIlliquidity is false, whatever the other answers. A Securitize Markets brokerage account is not available to the investor; tell them: “Based on your answers, a Securitize Markets brokerage account is not available to you at this time.”
processing — the answers above qualify, but isLicensedSecuritiesProfessional or isAffiliatedWithSecuritiesFirm is true. Securitize’s compliance team reviews the account and may contact the investor; the investor.suitability.updated webhook announces its decision.

Securitize can change which answers lead to each verdict: act on the verificationStatus you receive, not on the answers you sent. An entity’s suitability reads verified at once.

After a compact suitability. An individual who took the compact suitability can complete the full one with this call while its verdict is verified.

A verdict under review or not approved. While the full suitability is not complete and the investor’s verdict is processing or rejected — from a compact suitability, or set by Securitize’s compliance team — the call answers 422 with details.reason suitability_under_review or suitability_not_approved and stores nothing.

An invalid body answers 400 with every field to fix and stores nothing. The three declarations must be true: they attest that the investor was given and reviewed the current Securitize Markets, LLC Subscriber Agreement and Form CRS, as supplied to your account by Securitize, and confirmed the affirmations described on the field.

POST

investors

{investorId}

suitability

Send the investor's suitability

curl --request POST \
  --url https://partners-api.sandbox.securitize.io/investors/v1/onboarding-reliance/investors/{investorId}/suitability \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "isLicensedSecuritiesProfessional": false,
  "isAffiliatedWithSecuritiesFirm": false,
  "educationLevel": "higher_education",
  "annualIncome": "100k_to_250k",
  "netWorth": "500k_to_1m",
  "investablePercentageOfNetWorth": "10_to_25",
  "investmentApproach": "aggressive_growth",
  "investmentHorizon": "3_to_5_years",
  "lossTolerance": "over_30_percent",
  "acceptsIlliquidity": true,
  "occupation": "employee",
  "declaresLawfulOriginOfFunds": true,
  "isPoliticallyExposedPerson": false,
  "assetExperience": {
    "equities": {
      "experience": "some",
      "knowledge": "some",
      "tradingFrequency": "occasionally"
    },
    "fixedIncome": {
      "experience": "some",
      "knowledge": "some",
      "tradingFrequency": "occasionally"
    },
    "collectiveInvestment": {
      "experience": "some",
      "knowledge": "some",
      "tradingFrequency": "occasionally"
    },
    "optionsAndDerivatives": {
      "experience": "none",
      "knowledge": "none",
      "tradingFrequency": "never"
    },
    "digitalAssets": {
      "experience": "some",
      "knowledge": "some",
      "tradingFrequency": "occasionally"
    },
    "privatePlacements": {
      "experience": "none",
      "knowledge": "some",
      "tradingFrequency": "never"
    },
    "realEstate": {
      "experience": "none",
      "knowledge": "some",
      "tradingFrequency": "never"
    }
  },
  "declarations": {
    "subscriberAgreementReviewed": true,
    "formCrsReviewed": true,
    "affirmationsConfirmed": true
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    isLicensedSecuritiesProfessional: false,
    isAffiliatedWithSecuritiesFirm: false,
    educationLevel: 'higher_education',
    annualIncome: '100k_to_250k',
    netWorth: '500k_to_1m',
    investablePercentageOfNetWorth: '10_to_25',
    investmentApproach: 'aggressive_growth',
    investmentHorizon: '3_to_5_years',
    lossTolerance: 'over_30_percent',
    acceptsIlliquidity: true,
    occupation: 'employee',
    declaresLawfulOriginOfFunds: true,
    isPoliticallyExposedPerson: false,
    assetExperience: {
      equities: {experience: 'some', knowledge: 'some', tradingFrequency: 'occasionally'},
      fixedIncome: {experience: 'some', knowledge: 'some', tradingFrequency: 'occasionally'},
      collectiveInvestment: {experience: 'some', knowledge: 'some', tradingFrequency: 'occasionally'},
      optionsAndDerivatives: {experience: 'none', knowledge: 'none', tradingFrequency: 'never'},
      digitalAssets: {experience: 'some', knowledge: 'some', tradingFrequency: 'occasionally'},
      privatePlacements: {experience: 'none', knowledge: 'some', tradingFrequency: 'never'},
      realEstate: {experience: 'none', knowledge: 'some', tradingFrequency: 'never'}
    },
    declarations: {
      subscriberAgreementReviewed: true,
      formCrsReviewed: true,
      affirmationsConfirmed: true
    }
  })
};

fetch('https://partners-api.sandbox.securitize.io/investors/v1/onboarding-reliance/investors/{investorId}/suitability', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://partners-api.sandbox.securitize.io/investors/v1/onboarding-reliance/investors/{investorId}/suitability"

payload = {
    "isLicensedSecuritiesProfessional": False,
    "isAffiliatedWithSecuritiesFirm": False,
    "educationLevel": "higher_education",
    "annualIncome": "100k_to_250k",
    "netWorth": "500k_to_1m",
    "investablePercentageOfNetWorth": "10_to_25",
    "investmentApproach": "aggressive_growth",
    "investmentHorizon": "3_to_5_years",
    "lossTolerance": "over_30_percent",
    "acceptsIlliquidity": True,
    "occupation": "employee",
    "declaresLawfulOriginOfFunds": True,
    "isPoliticallyExposedPerson": False,
    "assetExperience": {
        "equities": {
            "experience": "some",
            "knowledge": "some",
            "tradingFrequency": "occasionally"
        },
        "fixedIncome": {
            "experience": "some",
            "knowledge": "some",
            "tradingFrequency": "occasionally"
        },
        "collectiveInvestment": {
            "experience": "some",
            "knowledge": "some",
            "tradingFrequency": "occasionally"
        },
        "optionsAndDerivatives": {
            "experience": "none",
            "knowledge": "none",
            "tradingFrequency": "never"
        },
        "digitalAssets": {
            "experience": "some",
            "knowledge": "some",
            "tradingFrequency": "occasionally"
        },
        "privatePlacements": {
            "experience": "none",
            "knowledge": "some",
            "tradingFrequency": "never"
        },
        "realEstate": {
            "experience": "none",
            "knowledge": "some",
            "tradingFrequency": "never"
        }
    },
    "declarations": {
        "subscriberAgreementReviewed": True,
        "formCrsReviewed": True,
        "affirmationsConfirmed": True
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "status": "completed",
  "verificationStatus": "verified"
}

Authorizations

Authorization

string

header

required

OAuth 2.0 client credentials. Exchange the client id and secret Securitize issued you for a bearer token at the token URL (the host root, not under the base URL), with grant_type=client_credentials; the token lasts 2 hours and goes in the Authorization: Bearer header of every request. No scope is needed. The token identifies your partner account, so you never send a partner id, and every record you create is scoped to you.

Path Parameters

investorId

string

required

The investorId Securitize returned when you created the investor. Not your externalInvestorId.

Identifier assigned by Securitize, opaque and specific to your partner account. Store it as an opaque string.

Minimum string length: 1

Example:

"6aca84e5dc49fe8369dd1da4"

Body

application/json

The investor's suitability profile, complete in one call.

isLicensedSecuritiesProfessional

boolean

required

Registered or licensed to sell securities in any jurisdiction (FINRA, FCA, BaFin or equivalent).

isAffiliatedWithSecuritiesFirm

boolean

required

The investor or immediate family is employed by or associated with a securities firm, brokerage or regulated exchange.

educationLevel

enum<string>

required

Highest education level.

Available options:

basic,

high_school,

higher_education,

college

annualIncome

enum<string>

required

Annual income, in US dollars.

Available options:

under_50k,

50k_to_100k,

100k_to_250k,

over_250k

netWorth

enum<string>

required

Net worth, in US dollars.

Available options:

under_100k,

100k_to_500k,

500k_to_1m,

over_1m

investablePercentageOfNetWorth

enum<string>

required

Share of net worth the investor intends to invest, in percent.

Available options:

under_10,

10_to_25,

over_25

investmentApproach

enum<string>

required

Investment approach.

Available options:

capital_preservation,

balanced_growth,

aggressive_growth

investmentHorizon

enum<string>

required

How long the investor expects to hold investments.

Available options:

under_3_years,

3_to_5_years,

over_5_years

lossTolerance

enum<string>

required

Loss the investor could bear without affecting their standard of living, as a share of invested capital.

Available options:

up_to_10_percent,

up_to_30_percent,

over_30_percent

acceptsIlliquidity

boolean

required

The investor understands securities may be illiquid and has no immediate need for liquidity. For an individual, false rejects the suitability.

isPoliticallyExposedPerson

boolean

required

The investor or immediate family is currently a politically exposed person.

assetExperience

object

required

Experience with each of the seven asset classes; all seven are required.

Show child attributes

declarations

object

required

Your attestation that the investor completed the documents step. All three must be true.

Show child attributes

employerName

string

The firm the investor is licensed through. Required when isLicensedSecuritiesProfessional is true; omit it when false.

Required string length: 1 - 255

occupation

enum<string>

Occupation.

Available options:

employee,

self_employed,

retired,

student,

unemployed

declaresLawfulOriginOfFunds

boolean

The investor's resources and income come from lawful activities.

Response

The current state. Without a change when a suitability was already complete.

The investor's suitability state.

status

enum<string>

required

Whether the questionnaire is complete.

Available options:

not_started,

completed

verificationStatus

enum<string>

required

Securitize's verdict. none — not verified. verified — verified. processing — under review by Securitize's compliance team. rejected — not approved. Only verified counts as verified; contact Securitize if another value persists.

Available options:

none,

processing,

verified,

rejected

Get started

Guides

Concepts

Help

API reference

Send the investor's suitability

Authorizations

Path Parameters

Body

Response