The initial investment flow depends on the type of fund. Some funds require settlement before close. Some funds (drawdown funds) do not. To make an initial investment, your org needs to:
(Optional) Request asset creation dry run to validate subscription data.
See the dryRun option for the Create Asset endpoint.
With subscription validated, request subscription (create asset).
You can specify correlation IDs for new investors and accounts as part of the Create Asset payload.
Receive and parse accept/reject notification.
Update internal systems to reflect the status of the request.
If settlement is required:
a. Wire payment separately and mark as wired.
b. Receive and parse "securities issued" notification.
c. Update asset information for internal systems.
The account relationship type '{provided}' is not compatible with share class required type '{required}'
AC0013
Account name is mandatory for new accounts
AC0014
Account type is mandatory for new accounts
AC0016
Account relationshipType is mandatory for new accounts
Asset
AS0015
Can't create transaction on security '{securityId}' before its start date: '{startDate}'
AS0016
Can't create transaction on security '{securityId}' after the current date
Issuance (Security)
IS0012
Security '{securityId}' is in invalid state for the current action. Current status: '{currentState}'. Required status: '{allowedStates}'
IS0028
The minimum investment amount is '{minInvestment}'
IS0029
The offering's '{issuanceId}' maximum amount '{maxAmount}' has been reached
IS0030
This investment exceeds the amount available on this offering
IS0034
The provided front end fee ({providedFee}) exceeds the maximum defined for this security ({maxFee})
Investor
IV0004
The accreditation level '{accreditationLevel}' of investor '{investorId}' is not compatible with security's regulation '{issuanceRegulation}'
IV0005
Regulation RegS is not available for US investor '{investorId}'
IV0006
Investor type is mandatory for new accounts
IV0007
Investor name is mandatory for new accounts
IV0008
Investor individual info is mandatory for new accounts
IV0009
Investor type cannot be updated for existing accounts
IV0010
The accreditation level '{investorAccreditationLevel}' of the investor '{investorId}' is not compatible with the security's exemption '{issuanceExemption}'. Compatible accreditation levels: '{compatibleAccreditationLevels}'
IV0020
Investor legal entity info is mandatory for new accounts
IV0021
Trust information is mandatory for legal entities of type Trust
IV0022
Trust information can only be provided for legal entities of type Trust
IV0023
Accreditation Other is not available for US investor
Other Business Rule Validations
Type
Code
Message
Account
AC0007
Intermediary bank account must be provided for further credit
AC0017
Account type cannot be updated for existing accounts
AC0020
Account can only be updated by the owner organization
AC0028
The investors list cannot be changed for an account that has assets that have been accepted by the issuer or recalled by the investor
AC0029
Updating omnibus account is not allowed for current action.
AC0044
Two or more duplicated correlation ids {orgCorrelationId} were provided for account
AC0048
Account additional type info can only be set if account type or subtype are set to 'Other'
AC0049
Cannot set subtype '{subType}' for account type '{type}'. Allowed subtypes are: '{allowed}'
Advisor
AD0012
Advisor can only be updated by the owner organization
AD0015
Data provided for advisor {advisorId} is not same as provided in completedByAdvisor property.
AD0016
Correlation ids provided in completedByAdvisor are not linked to same advisor
AD0017
Correlation data provided for existing advisor: '{advisorId}'
AD0018
Two or more duplicated correlation ids {orgCorrelationId} were provided for advisor
Asset
AS0013
The following asset ids can't be found{orInDifferentStatus}: '{invalidAssetIds}'
AS0017
'{providedProp}' should not be provided. Expected property is '{expectedProp}'
AS0018
Multiple entries detected for asset '{uniqueId}'
AS0024
Action cannot be performed for security with '{type}' type and capital call enabled.
AS0029
Two or more duplicated correlation ids {orgCorrelationId} were provided for asset
Exclusivity
EX0006
You need an accepted assignment to the exclusivity list in order to act on this security.
Files
FL0001
The following files could not be found in the correct status: '{fileIds}'
FL0006
The file correlation ids '{correlationIds}' are already in use
FL0010
Documents cannot be reused both as investor documents and transaction data documents
FL0011
Investor documents can only be reused by the investor that owns them
FL0028
Concurrent execution. There are '{lockedAmount}' file(s) marked as locked by another process
Issuance (Security)
IS0026
Active campaign period has not started yet.
IS0027
Campaign active period has already ended.
IS0099
You do not have the role for this action on security '{securityId}'. Required roles: '{requiredRoles}'; current roles: '{currentRoles}'
Investor
IV0013
Investor can only be updated by the owner organization
IV0035
Data provided: {data} is incompatible with investor type: {type}.
Technical Validations
Type
Code
Message
Account
AC0002
Account with correlation Id '{correlationId}' not found.
AC0009
The account correlation ids '{correlationIds}' are already in use
AC0050
Correlation id '{correlationId}' cannot be provided alongside account id '{accountId}' or booked account id '{bookedAccountId}'
Advisor
AD0022
Advisor name is mandatory for new advisors
AD0023
Advisor type is mandatory for new advisors
Asset
AS0004
Asset '{assetId}' is locked for edit by another process. Please try again later.
AS0023
Action can only be performed by the owner organization. Ids of the assets with the different owner: '{assetIds}'
AS0026
This asset correlation {orgCorrelationId} is locked for edit by another process. Please try again later.
Auth (OAuth)
AU0001
The access token is invalid or missing. Please provide a valid access token issued by the OAuth server using the client credentials grant (default location is on the authorization header).
AU0002
You do not have access to this scope: '{scope}'
AU0003
The core access token is invalid for organization '{orgId}'.
Contact Info
CI0001
Contact preference type 'other' requires 'additionalTypeInfo' to be provided.
CI0002
Duplicate contact preference types found: '{duplicateTypes}' for subject: '{subject}'
Custodian can only be updated by the owner organization
CT0015
Two or more duplicated correlation ids {orgCorrelationId} were provided for custodian
CT0017
Custodian name is invalid
CT0019
Correlation data provided for existing custodian: '{custodianId}'
CT0020
Correlation id '{correlationId}' cannot be provided alongside custodian id '{custodianId}' or booked custodian id '{bookedCustodianId}'.
Files
FL0002
Provided data must contain either uploadData or fileId properties
FL0003
Provided data cannot contain both uploadData and fileId
FL0004
Found duplicated fileId '{fileId}' in multiple files
FL0005
Found duplicated correlationId '{correlationId}' in multiple files
FL0008
File with Correlation ID '{correlationId}' not found
FL0017
Two or more duplicated correlation ids '{orgCorrelationId}' were provided for file
FL0019
Correlation id '{correlationId}' cannot be provided alongside file id '{fileId}'.
FL0020
Multiple entries for the same file '{fileId}' detected in the payload.GN0002: The payload you have supplied is invalid.
Generic
GN0003
This request is being blocked because it is marked as a resubmission (i.e. you have supplied the same exact payload to this endpoint within a {ttlWindow} seconds window)
GN0008
The booked {type} id {entityId} was not found
Issuance (Security)
IS0001
Security '{securityId}' is a parent offering. Please use one of the share class offerings: '{shareClassIds}'
IS0008
Security id was not provided
IS0009
The security id '{securityId}' is invalid
IS0013
Security '{securityId}' is restricted
IS0106
Cannot provide both Security id and correlation data at same time
Investor
IV0002
Investor with correlation Id '{correlationId}' not found.
IV0003
The investor correlation ids '{correlationIds}' are already in use
IV0016
Duplicated investor ids detected
IV0017
Duplicated investor correlation ids detected
IV0032
Two or more duplicated correlation ids {orgCorrelationId} were provided for investor
IV0036
Duplicated form PF data detected for type {type}"|technicalValidations|EC002|"Investor Information & AML/KYC Issue(s).
IV0037
Correlation id '{correlationId}' cannot be provided alongside investor id '{investorId}' or booked investor id '{bookedInvestorId}'.
Questionnaires
QU0001
You cannot use 'allowedAnswerValues' in a question with the answerType '{currentAnswerType}'. It is only to be used when the answerType is 'Choice'. Questionnaire type: '{questionnaireType}', question text: '{questionText}'
QU0002
You cannot provide more than 1 answer in a question with the answerType '{currentAnswerType}'. Questionnaire type: '{questionnaireType}', question text: '{questionText}'
QU0003
The answer for the question with answerType '{currentAnswerType}' is expected to have exactly one '{expectedValue}' property. Provided properties: '{provided}'. Questionnaire type: '{questionnaireType}', question text: '{questionText}'
QU0004
The choice values '{provided}' is not part of the allowed answer values for question with the questionText: '{questionText}'. Questionnaire type: '{questionnaireType}'
QU0005
Duplicate answer ids found for question '{questionText}': '{ids}'. Questionnaire type: '{questionnaireType}'
QU0006
Duplicate values found for question '{questionText}': '{answers}'. Questionnaire type: '{questionnaireType}'
