Investments

Each investment represents a contract between the issuer of a product and the investor.

Investments can only be created by distribution platform via the Distributor API

Retrieving investments

You have access to all investments create by all distribution platforms via the distributor API your product is listed.

You can use the /investments endpoint together with your product_id to receive all investment_ids for such a product.

Retrieving investment details

With an investment_id you can receive all necessary information of an investment by calling /investments/{id}. This is the list of data you are able to access:

• Campaign_id

• status

• Units

• Disagio

• Accured_interest

• Investment_amount

• Payment_total

• Remaining_amount

• signed_at

• accepted_at

• paid_at

• delivered_at

• cancellation_date

• cancellation_reason

• payment_details

• bank_account

• communcation

• natural_person

• legal_person

• securities_deposit_account

• tax_information

• exemption_order_amount

Status field codes

The status field of an investment may have one of the following values:

Status	Description
KYC_PENDING	The investment is signed but the identification process for the investor is still pending.
REVIEW_PENDING	The external review process is still pending.
WAITING_FOR_ACCEPTANCE	The investment is ready to be accepted by the issuer.
ACCEPTED	The investment has been accepted by the issuer.
PAID	The investment amount has been marked as paid.
DELIVERED	The digital securities have been credited to the recipient's wallet. This is the final state of the process.
KYC_INSUFFICIENT	The KYC/AML check could not be completed successfully due to missing or inconsistent data.
ABORTION	The order has been canceled by the investor.
REJECTION	Order execution has been rejected by the issuer.
CANCELLATION	The contract has been canceled by the investor during the cancellation period.
PAYMENT_MISSING	The order has been canceled because the payment has not yet arrived on time.