---
title: "List investors"
method: GET
path: "/v1/investors"
tags: ["investors"]
---

# List investors

`GET /v1/investors`

## Request

- Base URL: `https://api.datahyena.com`
- URL: `https://api.datahyena.com/v1/investors`
- Auth: API key in header `X-API-Key`

Search and filter investor records. Costs one credit per returned record.

## Query parameters

- `cursor` string
- `since` string
- `limit` number
- `search` string
- `type` string[]
- `countries` string[]
- `domain` string
- `includeTotal` boolean
- `hasFirmographics` boolean
- `minRoundUsd` number
- `minRounds` number
- `activeSince` string
- `investsIn` string[]

## Response `200`

Request accepted. The number of records returned may be lower than limit when credits or data run out.

- object
  - `success` true, required
  - `data` PublicInvestorResponseItem[], required
    - `id` string, required
    - `name` string, required
    - `type` 'vc' | 'angel' | 'cvc' | 'pe' | 'growth' | 'accelerator' | 'family_office' | 'syndicate' | 'unknown', required
    - `hqCountry` CountryDto, required
      - `code` string, required: ISO 3166-1 alpha-2 country code.
      - `name` string, required: Human-readable country name.
    - `domain` object, nullable, required
    - `roundsCount` number, required: Funding rounds this investor has participated in.
    - `largestRoundUsd` object, nullable, required: Largest round this investor has participated in, in whole USD.
    - `firstRoundAt` object, nullable, required
    - `lastRoundAt` object, nullable, required
    - `activeMarkets` CountryDto[], required: Countries this investor has funded companies in, most-backed first.
      - `code` string, required: ISO 3166-1 alpha-2 country code.
      - `name` string, required: Human-readable country name.
  - `pagination` PublicPagination, required
    - `hasMore` boolean, required: Whether another page is available.
    - `nextCursor` object, nullable, required: Cursor to pass to the next request. Null when hasMore is false.
    - `total` number: Total records matching the filters across all pages. Present only when includeTotal=true; the same on every page of a listing.
  - `meta` PublicResponseMeta, required
    - `endpoint` string, required: Stable endpoint identifier for logging and support.
    - `creditsUsed` number, required: Credits consumed by this request after the response size is known.
    - `creditsRemaining` object, nullable, required: Workspace credits remaining after this request.
    - `notice` string: Present only when a lookup resolved nothing. Absence of a company is an ordinary outcome here, not a failed request: records are built from funding, acquisition and executive-move announcements, so a company that has not appeared in one is simply not covered.

## Other responses

- `400`: Invalid query parameter, body, or pagination cursor.
- `401`: Missing, invalid, or disabled API key.
- `402`: Workspace has no credits available for the request.
- `403`: Request blocked by abuse prevention policy.
- `429`: Rate limit exceeded for this workspace and plan.

---

[API](https://skmtc.dev/datahyena/apis/datahyena-public-api.md) · [All operations](https://skmtc.dev/datahyena/apis/datahyena-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/datahyena/apis/datahyena-public-api/revisions/0de0060625e4?raw)