Send Signed Subscription Note
Introduction
This resource is used to send us the proof of signature of an investor's subscription note to a fund's quota offering.
This resource is available only for integrations acting as Distributor. Use the API key and the host of the Distributor profile: see Environments (Hosts).
Input / Output:
As input, the subscription information, the UUID of the quota offering the investor subscribed to, the signature method and, depending on the method, the content needed for validation must be sent. See the example below.
As output, the full object of the created subscription note is delivered, including the subscription_note_key, which identifies the note. The note is created already in the active status (or sold_off, if remaining_subscription_note_value is zero).
Request
Request body
{
"number_of_quotas": 500.0,
"original_subscription_note_value": 50000.00,
"start_date": "2026-01-15",
"maturity_date": "2026-12-31",
"quota_offering_key": "UUID",
"transaction_type": "ted",
"signature_method": "opt_in",
"opt_in_hash" : "OPT_IN_HASH"
}
| Field | Type | Description | Required |
|---|---|---|---|
original_subscription_note_value | number | Note value. Minimum 0. Cannot exceed the offering's remaining value | Yes |
quota_offering_key | string | UUID of the quota offering. The offering must be active, with remaining value and no pending amendment | Yes |
transaction_type | string | ted or b3 | Yes |
signature_method | string | Signature method used. With opt_in, send opt_in_hash; with any other method, send document_b64 | Yes |
opt_in_hash | string | Opt-in hash (up to 250 characters) | No |
document_b64 | string | Signed note encoded in base64 | No |
number_of_quotas | number | Number of quotas of the note | No |
remaining_subscription_note_value | number | Remaining balance of the note. Cannot be greater than original_subscription_note_value | No |
start_date | string | Start date (YYYY-MM-DD). If omitted, the current date (UTC) is used | No |
maturity_date | string | Maturity date (YYYY-MM-DD). Cannot be in the past | No |
During the integration process, a means of authenticating the submitted hash will be required.
Response
The response has the same format as the Request Subscription Note response.
Errors
| Status | Code | When it happens |
|---|---|---|
| 400 | QOF000020 | maturity_date is in the past |
| 400 | QOF000026 | The note value is greater than the offering's remaining value |
| 400 | QOF000046 | Invalid transaction_type |
| 400 | QOF000047 | The investor's classification does not allow subscribing to the offering |
| 400 | QOF000068 | Invalid signature_method |
| 400 | QOF000069 | signature_method is opt_in and opt_in_hash was not sent |
| 400 | QOF000072 | signature_method is not opt_in and document_b64 was not sent |
| 400 | QOF000150 | remaining_subscription_note_value is greater than original_subscription_note_value |
| 400 | QIT000004 | The integration is not the investor's distributor |
| 404 | QOF000017 | Investor not found |
| 404 | QOF000019 | Quota offering not found |
| 404 | QOF000039 | The offering is not active, has expired or has no remaining value |
| 409 | QOF000152 | The offering has an amendment waiting for approval |
Authentication, permission and host errors: see API Errors.