Make Initial Investments
Description
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.
Diagrams
Endpoints
Create Asset (Lot) - Dry Run
AC0002 AC0006 AC0007 AC0009 AC0010 AC0013 AC0014 AC0016 AC0020 AC0029 AC0037 AC0039 AC0044 AC0048 AC0049 AC0050 AC0063 AC0064 AD0003 AD0006 AD0012 AD0015 AD0016 AD0017 AD0018 AD0022 AD0023 AS0009 AS0015 AS0016 AS0017 AS0026 AS0029 AS0045 AU0001 AU0002 AU0003 CI0001 CI0002 CI0003 CT0003 CT0007 CT0011 CT0015 CT0017 CT0019 CT0020 EX0006 FL0001 FL0002 FL0003 FL0004 FL0005 FL0006 FL0008 FL0010 FL0011 FL0012 FL0017 FL0019 FL0020 FL0028 GN0002 GN0003 GN0008 IS0001 IS0008 IS0009 IS0012 IS0013 IS0026 IS0027 IS0028 IS0029 IS0030 IS0034 IS0099 IS0106 IS0119 IV0002 IV0003 IV0004 IV0005 IV0006 IV0007 IV0008 IV0009 IV0010 IV0013 IV0016 IV0017 IV0020 IV0022 IV0023 IV0024 IV0027 IV0032 IV0035 IV0036 IV0037 IV0042 PO0001 QU0001 QU0002 QU0003 QU0004 QU0005 QU0006 QU0007 QU0008 QU0009 QU0010
Create Asset (Lot)
AC0002 AC0006 AC0007 AC0009 AC0010 AC0013 AC0014 AC0016 AC0020 AC0029 AC0037 AC0039 AC0044 AC0048 AC0049 AC0050 AC0063 AC0064 AD0003 AD0006 AD0012 AD0015 AD0016 AD0017 AD0018 AD0022 AD0023 AS0009 AS0015 AS0016 AS0017 AS0026 AS0029 AS0045 AU0001 AU0002 AU0003 CI0001 CI0002 CI0003 CT0003 CT0007 CT0011 CT0015 CT0017 CT0019 CT0020 EX0006 FL0001 FL0002 FL0003 FL0004 FL0005 FL0006 FL0008 FL0010 FL0011 FL0012 FL0017 FL0019 FL0020 FL0028 GN0002 GN0003 GN0008 IS0001 IS0008 IS0009 IS0012 IS0013 IS0026 IS0027 IS0028 IS0029 IS0030 IS0034 IS0099 IS0106 IS0119 IV0002 IV0003 IV0004 IV0005 IV0006 IV0007 IV0008 IV0009 IV0010 IV0013 IV0016 IV0017 IV0020 IV0022 IV0023 IV0024 IV0027 IV0032 IV0035 IV0036 IV0037 IV0042 PO0001 QU0001 QU0002 QU0003 QU0004 QU0005 QU0006 QU0007 QU0008 QU0009 QU0010
Mark Asset Batch as Wired
AS0004 AS0013 AS0018 AS0023 AS0024 AU0001 AU0002 AU0003 GN0002 IS0008 IS0009 IS0012 IS0013 IS0099 IS0106 IS0119
Error Codes and Messages
Key Validations
Account
AC0006
Please provide ABA or SWIFT
AC0010
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
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
Account
AC0007
Intermediary bank account must be provided for further credit
AC0020
Account can only be updated by the owner organization
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}'
AC0063
Beneficiary name is mandatory, at least one of the properties should be provided: {data}
AC0064
Authorized signer name is mandatory, at least one of the properties should be provided: {data}
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
AS0045
Correlation data maps to different accounts.
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}'
IS0119
Issuance '{securityId}' has an active full sync job
Investor
IV0013
Investor can only be updated by the owner organization
IV0035
Data provided: {data} is incompatible with investor type: {type}.
IV0042
Authorized signer name is mandatory, at least one of the properties should be provided: {data}
Technical Validations
Account
AC0002
Account with correlation Id '{correlationId}' not found.
AC0009
The account correlation ids '{correlationIds}' are already in use
AC0037
Account '{accountId}' is locked for edit by another process. Please try again later.
AC0039
This account correlation {orgCorrelationId} is locked for edit by another process. Please try again later.
AC0050
Correlation id '{correlationId}' cannot be provided alongside account id '{accountId}' or booked account id '{bookedAccountId}'
Advisor
AD0003
Advisor '{advisorId}' is locked for edit by another process. Please try again later.
AD0006
This advisor correlation {orgCorrelationId} is locked for edit by another process. Please try again later.
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}'
CI0003
Duplicate contact preference subject ids found: '{subjectIds}'
Custodian
CT0003
Custodian '{custodianId}' is locked for edit by another process. Please try again later.
CT0007
The custodian correlation ID '{correlationId}' is locked for edit by another process. Please try again later.
CT0011
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
FL0012
This file correlation '{orgCorrelationId}' is locked for edit by another process. Please try again later.
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
IV0024
Investor '{investorId}' is locked for edit by another process. Please try again later.
IV0027
This investor correlation {orgCorrelationId} is locked for edit by another process. Please try again later.
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}'.
Position
PO0001
Position '{positionId}' is locked for edit by another process. Please try again later.
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}'
QU0007
Duplicate questionnaire ids found: '{ids}'
QU0008
Duplicate questionnaire types found: '{types}'
QU0009
Duplicate question ids found: '{ids}'. Questionnaire type: '{questionnaireType}'
QU0010
Duplicate allowed answer values found for question '{questionText}': '{values}'. Questionnaire type: '{questionnaireType}'.
Last updated
Was this helpful?