Create an investment session

POST 
/offerings/:id/investment_sessions

Canonical path: the offering comes from the URL, so spv_id may be omitted from the body (if sent it must match, else 422 offering_mismatch). Authorized for any offering the caller may act on (an install on its syndicate or company, a role on it, or created by your app).

Creates a single-use, recipient-specific hosted investment session (analogous to a Stripe Checkout Session) on the SPV named by spv_id in the body. The session walks one investor through accreditation, document signing, and payment, and produces a durable Investment on success. Returns a url the recipient opens to begin. If the recipient already has an active session on the SPV, that session is returned instead of creating a duplicate; if another app holds that recipient's active session there, the create is refused with 409 session_conflict (a recipient has one active session per offering).

Request

Responses

201

Investment session created

401

Authentication required or token is invalid/expired. This error occurs when:

• No Authorization header is provided
• The access token is invalid or malformed
• The access token has expired
• The access token has been revoked

To resolve: Obtain a new access token using the OAuth 2.0 flow.

403

The authenticated user does not have permission to access this resource. This typically means:

• The user is authenticated but lacks the required OAuth scope
• The resource belongs to a different user
• The user's role doesn't allow this operation

Check that your OAuth token includes the necessary scopes for this endpoint.

404

The requested resource does not exist or is not visible to this token.

409

The request conflicts with the resource's current state (for example, opening an SPV that is already open, or closing one that is not yet open).

422

One or more request fields failed validation.