List portfolio companies

GET 
/v1/portfolio/companies

Returns every company that granted this connector an active connection and currently holds the qualifying plan on its main subscription. Requires a Connector Token (no company_id).

Plan membership is resolved from the source of truth on read, so a company that lost the plan stops being listed without any action from you. meta.as_of reports how fresh that data is.

Required scope: portfolio:read

Request

Responses

200

Companies in the connector portfolio.

401

Unauthenticated — the request is missing a credential, or the Bearer token / API key is invalid, expired, or revoked.

403

Insufficient scope — the credential is authenticated but lacks a scope the endpoint requires.

404

Not found — no resource matches the id in the path (or it belongs to a different company).

422

Validation failed — the request body failed schema validation. errors[] lists every offending field.