Skip to main content
GET
Read the investor's DLT test

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 DLT test.

The DLT test, with the latest attempt's letters when you sent it.

status
enum<string>
required

not_started — no attempt yet. failed — the last attempt failed and attempts remain. passed — passed; nothing more to do. locked — three attempts failed; it cannot be retaken through the API.

Available options:
not_started,
failed,
passed,
locked
required
boolean
required

Whether the test applies to this investor, from the country of its current address.

attemptsUsed
integer
required

Attempts used so far, by every partner and by the investor.

attemptsRemaining
integer
required

Attempts left, 0 to 3.

verificationStatus
enum<string>
required

The investor's EU suitability verdict, verified once the test is passed and the suitability is complete.

Available options:
none,
processing,
verified,
rejected
answers
object

The latest attempt, present only when you sent it.