Skip to main content
GET
Read the investor's suitability

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"

Response

The suitability, with your answers if you sent them.

The suitability, with the answers when you sent them.

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
answers
object

Your answers, present only when you sent the suitability.