companies

List companies

Returns portfolio companies. When vehicle is provided, scopes to that vehicle's holdings. When omitted, returns all companies across every vehicle the caller has access to.

get/v1/companies

Request

  • Base URL
    https://api.angellist.com
  • Auth
    OAuth 2
    Authorization code: https://gateway.angellist.com/oauth/authorize
    Client credentials
    Token URL: https://gateway.angellist.com/oauth/token scopes: companies:read

Query parameters

vehiclestring
Example:vhcl_k9Rm3nQp8wL1YxTa

Optional vehicle filter. When provided, only companies held by this vehicle are returned. When omitted, returns companies across all vehicles the caller can manage.

statusstring
Example:active

Filter companies by operational status. Accepted values: active, exit_in_progress, acquired, dissolved.

company_typestring
Example:operating_company

Filter companies by entity classification. Accepted values: operating_company, blockchain_network, external_fund, holding_company, platform_fund.

created_afterinteger
Example:1713830400

Only return companies created after this Unix timestamp (inclusive).

created_beforeinteger
Example:1713830400

Only return companies created before this Unix timestamp (inclusive).

limitinteger

Maximum number of results to return (1-100, default 25).

starting_afterstring

Cursor for forward pagination. Pass the id of the last item from the previous page to fetch the next page.

ending_beforestring

Cursor for backward pagination. Pass the id of the first item from the current page to fetch the previous page.

Response

A list of companies.

has_moreboolean required

Whether there are more items available after this page.

next_cursorstring

Cursor for the next page. Pass this value as starting_after to fetch the next page. Present only when has_more is true.

object'list' required
urlstring required

The URL for this list endpoint.

Example response

{
  "data": [
    {
      "description": "AI-powered warehouse robots",
      "id": "cmpny_AJqi2An4xbPF2fbz3f9DZhVL8tDCH",
      "logo_url": "https://cdn.angellist.com/startups/i/12345-abc-medium.jpg",
      "name": "Acme Robotics",
      "website": "https://acmerobotics.com"
    }
  ],
  "url": "/v1/companies"
}

Changes

No recorded changes to this operation across all 1 revision of this API.