Request data access for a portfolio company
Submits a data-access grant request to a portfolio company. The company must approve the request before financial endpoints (metrics:read) will return data. Only one live request per company is allowed. If a live (pending or approved) request already exists for this company and already covers the requested scopes, the endpoint is idempotent and returns the existing record with HTTP 200 instead of 201. If a live request exists but for different scopes, it returns 409 scope_conflict. Requires a valid API key (no specific scope).
Authorizations
Authorization: Bearer vein_sk_live_... or vein_sk_test_...
Body
Response
Idempotent. An equivalent request already exists; the existing record is returned.
A data-access grant request submitted by an investor to a portfolio company.
"ar_01jxyz"
access_request The portfolio company this request targets.
"startup_acme"
Scopes the company approved; empty until status is approved.
pending, approved, declined, expired, revoked "pending"
Optional human-readable explanation of why access is being requested.
When the grant expires.

