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:

1. (Optional) Request asset creation dry run to validate subscription data.

See the dryRun option for the Create Asset endpoint.

1. With subscription validated, request subscription (create asset).

You can specify correlation IDs for new investors and accounts as part of the Create Asset payload.

1. Receive and parse accept/reject notification.

2. Update internal systems to reflect the status of the request.

3. 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

Drawdown Funds

Other Funds

Endpoints

Task	How	Error Codes
Create Asset (Lot) - Dry Run	../primary/asset	AC0002 AC0006 AC0007 AC0009 AC0010 AC0013 AC0014 AC0016 AC0017 AC0020 AC0028 AC0029 AC0044 AC0048 AC0049 AC0050 AD0015 AD0016 AD0017 AD0018 AD0022 AD0023 AS0009 AS0015 AS0016 AS0017 AS0026 AS0029 AU0001 AU0002 AU0003 CT0015 CT0017 CT0019 CT0020 EX0006 FL0001 FL0002 FL0003 FL0004 FL0005 FL0006 FL0008 FL0010 FL0011 FL0017 FL0019 FL0020 FL00028 GN0002 GN0003 GN0008 IS0001 IS0008 IS0009 IS0012 IS0013 IS0026 IS0027 IS0028 IS0029 IS0030 IS0034 IS0099 IS0106 IV0002 IV0003 IV0004 IV0005 IV0006 IV0007 IV0008 IV0009 IV0010 IV0013 IV0016 IV0017 IV0020 IV0021 IV0022 IV0023 IV0032 IV0035 IV0036 IV0037
Create Asset (Lot)	../primary/asset	AC0002 AC0006 AC0007 AC0009 AC0010 AC0013 AC0014 AC0016 AC0017 AC0020 AC0028 AC0029 AC0044 AC0048 AC0049 AC0050 AD0012 AD0015 AD0016 AD0017 AD0018 AD0022 AD0023 AS0009 AS0015 AS0016 AS0017 AS0026 AS0029 AU0001 AU0002 AU0003 CI0001 CI0002 CI0003 CT0011 CT0015 CT0017 CT0019 CT0020 EX0006 FL0001 FL0002 FL0003 FL0004 FL0005 FL0006 FL0008 FL0010 FL0011 FL0017 FL0019 FL0020 FL0028 GN0002 GN0003 GN0008 IS0001 IS0008 IS0009 IS0012 IS0013 IS0026 IS0027 IS0028 IS0029 IS0030 IS0034 IS0099 IS0106 IV0002 IV0003 IV0004 IV0005 IV0006 IV0007 IV0008 IV0009 IV0010 IV0013 IV0016 IV0017 IV0020 IV0021 IV0022 IV0023 IV0032 IV0035 IV0036 IV0037 QU0001 QU0002 QU0003 QU0004 QU0005 QU0006 QU0007 QU0008 QU0009 QU0010
Mark Asset Batch as Wired	../primary/batch-mark-wired	AS0004 AS0013 AS0018 AS0023 AS0024 AU0001 AU0002 AU0003 GN0002 IS0008 IS0009 IS0012 IS0013 IS0099 IS0106

Error Codes and Messages

Key Validations

Type	Code	Message
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
	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}'
	CI0003	Duplicate contact preference subject ids found: '{subjectIds}'
Custodian	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
	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}'
	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}'.