> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [/docs/api/funding-rounds/openapi.json](/docs/api/funding-rounds/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Funding rounds: Search funding rounds

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

One endpoint of [Funding rounds](/docs/api/funding-rounds.md). Authentication, workspaces and errors: [/docs.md](/docs.md).

## Search funding rounds

`POST /v1/funding-rounds/search` - operationId `funding-rounds.search`

| Permission | Rate limit |
| --- | --- |
| Search view | 240 requests a minute per API key |

Search funding rounds with filters and get one page of rounds. Use it to find companies that just raised money.

Every filter is optional: `companies`, `industries`, `location`, `amountRaisedUsd`,
`roundRaisedUsd`, `roundSizeUsd`, `reportedWithinDays`, `reportedAfter`,
`reportedBefore`, `newRoundsOnly`, `revenueRanges`, `companyKinds`, `hasDomain`,
`foundedWithinYears` and `companyIds`. The three amount filters take a minimum and a maximum in whole
US dollars. `limit` sets the page size, and `cursor` takes the previous page's
`pagination.nextCursor`. `groupBy: "company"` returns one row per company, and
`includeFacets: true` adds facet counts.

The search is free and does not use the export allowance.

Errors:

- `400 validation_failed`: the body has an unknown key or a value that is not valid. `details[0].code`
gives the reason, for example `invalid_cursor`.
- `402 plan_required`: the workspace's plan does not include funding signals. `error.refusal` carries
the code `PLAN_FEATURE_NOT_AVAILABLE` and the feature `funding_signals`.
- `413 validation_failed`: the body is larger than 1 MB.
- `503 service_unavailable`: the funding data is not available right now. Try again.
- `504 upstream_timeout`: the funding data took too long to answer. Try again.

Requires Search view.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/funding-rounds/POST/v1/funding-rounds/search)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Ken-Version` | header | string, one of: 2026-11-02, 1.1 | no | The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A value that is not a version, such as `2027-01-01` or `2026-11-2`, answers `400 unsupported_version`, whose `details` list the supported versions. |
| `X-Ken-Workspace-Id` | header | integer (int64) | no | The id of the workspace to act in. Leave it out when your API key reaches only one workspace. When the key reaches more than one, a request without this header answers `400 workspace_required`. A workspace you are not a member of answers `404 not_found`. |

### Response 200

`data` is a `FundingRoundSearchPage`.

| Field | Type | Description |
| --- | --- | --- |
| `fundingRounds` | array of FundingRound | The rounds on this page. Present unless the search sets `groupBy` to `company`. |
| `companies` | array of FundingRoundCompanyGroup | The companies on this page with their matching rounds. Present only when `groupBy` is `company`. |
| `total` | integer (int64) | The rounds that match across all pages, or the companies with `groupBy: "company"`. It stops at 1,000 unless `totalMode` is `exact`, and is null when `totalMode` is `none`. |
| `totalIsCapped` | boolean | True when `total` stopped at 1,000, so more match. |
| `pagination` | FundingRoundPagination | How to get the next page. |
| `facets` | FundingRoundFacets | The matching rounds counted by industry, state, amount and company kind. Present only with `includeFacets: true`. |

### Request

```bash
curl -X POST "https://api.ken.so/v1/funding-rounds/search" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02" \
  -H "X-Ken-Workspace-Id: $KENSO_WORKSPACE_ID"
```

### Example response

```json
{
  "success": true,
  "data": {
    "fundingRounds": [
      {
        "id": "fr_482913570264819357",
        "reportedAt": "string",
        "firstSaleAt": "string",
        "isNewRound": true,
        "amountRaisedUsd": 1,
        "roundRaisedUsd": 1,
        "roundSizeUsd": 1,
        "isOpenEnded": true,
        "remainingUsd": 1,
        "minimumInvestmentUsd": 1,
        "investorCount": 1,
        "industry": "string",
        "revenueRange": "string",
        "company": {
          "id": 812,
          "name": "string",
          "domain": "acme.com",
          "websiteUrl": "https://example.com",
          "linkedinUrl": "https://example.com",
          "city": "string",
          "state": "string",
          "foundedYear": 1,
          "kind": "operating_company"
        },
        "people": [
          {
            "name": "string",
            "roles": []
          }
        ]
      }
    ],
    "companies": [
      {
        "company": {
          "id": 812,
          "name": "string",
          "domain": "acme.com",
          "websiteUrl": "https://example.com",
          "linkedinUrl": "https://example.com",
          "city": "string",
          "state": "string",
          "foundedYear": 1,
          "kind": "operating_company"
        },
        "roundCount": 1,
        "newestReportedAt": "string",
        "totalRaisedUsd": 1,
        "newestRound": {
          "id": "fr_482913570264819357",
          "reportedAt": "string",
          "firstSaleAt": "string",
          "isNewRound": true,
          "amountRaisedUsd": 1,
          "roundRaisedUsd": 1,
          "roundSizeUsd": 1,
          "isOpenEnded": true,
          "remainingUsd": 1,
          "minimumInvestmentUsd": 1,
          "investorCount": 1,
          "industry": "string",
          "revenueRange": "string",
          "company": {
            "id": 812,
            "name": "string",
            "domain": "acme.com",
            "websiteUrl": "https://example.com",
            "linkedinUrl": "https://example.com",
            "city": "string",
            "state": "string",
            "foundedYear": 1,
            "kind": "operating_company"
          },
          "people": [
            {}
          ]
        },
        "executives": [
          {
            "name": "string",
            "roles": []
          }
        ]
      }
    ],
    "total": 1,
    "totalIsCapped": true,
    "pagination": {
      "nextCursor": "eyJpZCI6ODE1fQ"
    },
    "facets": {
      "industries": [
        {
          "value": "string",
          "count": 1
        }
      ],
      "states": [
        {
          "value": "string",
          "count": 1
        }
      ],
      "amountBuckets": [
        {
          "key": "lt_1m",
          "min": 1,
          "max": 1,
          "count": 1
        }
      ],
      "companyKinds": [
        {
          "value": "string",
          "count": 1
        }
      ]
    }
  }
}
```

## Types

Each named type the tables above use, nested ones included.

### FundingRound

A company raising money: one report of a round, with its amounts, its company and the people named on it.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | The round's id: `fr_` followed by 18 digits. |
| `reportedAt` | string | no | The day the round was reported, as `yyyy-MM-dd`. |
| `firstSaleAt` | string | no | The day of the round's first sale, as `yyyy-MM-dd`. Null when unknown. |
| `isNewRound` | boolean | no | True when this is the first report of a new round, false for a later update of a round. |
| `amountRaisedUsd` | integer (int64) | no | The money this report adds, in whole US dollars: all of it sold for a new round, else the increase since the round's previous report. Null when unknown. |
| `roundRaisedUsd` | integer (int64) | no | The total sold in the round so far, in whole US dollars. Null when unknown. |
| `roundSizeUsd` | integer (int64) | no | The round's target size in whole US dollars. Null when the round is open-ended or the size is unknown. |
| `isOpenEnded` | boolean | no | True when the round has no set size. |
| `remainingUsd` | integer (int64) | no | The amount the round still offers, in whole US dollars. Null when unknown. |
| `minimumInvestmentUsd` | integer (int64) | no | The smallest investment the round accepts, in whole US dollars. Null when unknown. |
| `investorCount` | integer (int32) | no | How many investors have put money into the round. Null when unknown. |
| `industry` | string | no | The company's industry as reported with the round, for example `Other Technology`. Null when unknown. |
| `revenueRange` | string | no | The company's revenue range as reported with the round, for example `$1 - $1,000,000` or `Decline to Disclose`. Null when unknown. |
| `company` | FundingRoundCompany | no | The company that raised the round. |
| `people` | array of FundingRoundPerson | no | The people named on the round, without the organizations named on it. |

### FundingRoundCompanyGroup

A company on a `groupBy: "company"` search page, with its newest matching round.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `company` | FundingRoundCompany | no | The company. |
| `roundCount` | integer (int32) | no | How many of the company's rounds match the search. A round's reports count once. |
| `newestReportedAt` | string | no | The day of the company's newest matching report, as `yyyy-MM-dd`. |
| `totalRaisedUsd` | integer (int64) | no | The company's total raised to date across all its rounds, in whole US dollars. Null when unknown. |
| `newestRound` | FundingRound | no | The company's newest matching round. Null when it could not be read. |
| `executives` | array of FundingRoundPerson | no | The people with the `executive_officer` role on the newest matching round. |

### FundingRoundPagination

How to get the next page of funding rounds.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `nextCursor` | string | no | Send it as `cursor` with the same filters to get the next page. Null on the last page. |

### FundingRoundFacets

The matching rounds counted by facet, each list largest count first.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `industries` | array of FundingRoundValueCount | no | The matching rounds per industry, up to 100 industries. |
| `states` | array of FundingRoundValueCount | no | The matching rounds per state or country code the companies reported, up to 100 codes. |
| `amountBuckets` | array of FundingRoundAmountBucket | no | The matching rounds per range of total sold in the round. |
| `companyKinds` | array of FundingRoundValueCount | no | The matching rounds per company kind, using the `kind` values of a round's company. |

### FundingRoundCompany

The company that raised a round.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer (int64) | no | The company's id in the funding data, the value the `companyIds` filter takes. Null when unknown. |
| `name` | string | no | The company's name. Null when unknown. |
| `domain` | string | no | The company's web domain, for example `acme.com`. Null when unknown. |
| `websiteUrl` | string | no | The company's website URL. Null when unknown. |
| `linkedinUrl` | string | no | The company's LinkedIn page URL. Null when unknown. |
| `city` | string | no | The city the company reported with the round. Null when unknown. |
| `state` | string | no | The two-letter US state (DC and US territories included) the company reported. Null outside the US or when unknown. |
| `foundedYear` | integer (int32) | no | The year the company was founded, as reported with the round. Null when unknown. |
| `kind` | string | no | The kind of company: `operating_company`, `investment_fund`, `real_estate`, `financial_services` or `other`. Null when not classified. |

### FundingRoundPerson

A person named on a round.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | no | The person's full name. Null when unknown. |
| `roles` | array of string | no | The person's roles on the round: `executive_officer`, `director` or `promoter`. Empty when none of these applies. |

### FundingRoundValueCount

A facet value and how many matching rounds have it.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `value` | string | no | The facet value, as the matching filter takes it. |
| `count` | integer (int64) | no | How many matching rounds have this value. |

### FundingRoundAmountBucket

A range of total sold in a round and how many matching rounds fall in it.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `key` | string | no | The range: `lt_1m`, `1m_5m`, `5m_20m`, `20m_100m`, `gte_100m` or `unknown`. |
| `min` | integer (int64) | no | The range's lowest amount in whole US dollars, included. Null for `unknown`. |
| `max` | integer (int64) | no | The range's upper bound in whole US dollars, not included. Null for the open top range and for `unknown`. |
| `count` | integer (int64) | no | How many matching rounds fall in the range. |
