Retrieve an investment (current)

GET 
/investments/:id

The same record shape as the list, derived now from the investment rather than read from published state, so an investor who just acted sees the change at once. Available for any investment in the token's audience: the user's own (any status) or a founder-visible investment on a company the user edits. meta.published_matches says whether the published record already agrees; the sync stream converges within its interval.

Request

Responses

200

The current record.

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.

404

Not found, not in the token's audience, or not visible to it.

429

Too many requests in a short time period. The API enforces rate limits to ensure fair usage and system stability. When you exceed the limit, you'll receive this error along with headers indicating when you can retry.

Check the X-RateLimit-Reset header to know when your limit will reset. Consider implementing exponential backoff in your application.

Response Headers

X-RateLimit-Limit

Request limit per hour

X-RateLimit-Remaining

Remaining requests

X-RateLimit-Reset

UTC timestamp when the limit resets