> 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: Export 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).

## Export funding rounds

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

| Permission | Rate limit |
| --- | --- |
| Search view and the `export` permission | 240 requests a minute per API key |

Export every funding round that matches your filters, as JSON or as a CSV file.

The body takes the same filters as `POST /v1/funding-rounds/search`, plus `format` (`json`, the
default, or `csv`) and `limit` (default 100). The export can return at most the smallest of
`limit`, 5,000 rows, and the rows left in this month's allowance. When more rounds match, Kenso exports
nothing and answers `422`, so narrow the filters or raise `limit`. On Kenso Lifetime, the funding
results the license has left today cap the export too, and the rows it returns count against them.

A successful export uses one allowance row per returned row and sets the `X-Ken-Row-Count` header. A JSON
export answers `application/json`, the rounds in `data.fundingRounds`. A CSV export answers the file, not
an envelope: `Content-Type: text/csv; charset=utf-8` and
`Content-Disposition: attachment; filename="funding-rounds-{yyyyMMdd-HHmmss}.csv"`, the time in UTC. Errors
are JSON either way. A failed export uses nothing. Check what is left with
`GET /v1/funding-rounds/export-allowance`.

Errors:

- `400 validation_failed`: the body is not a JSON object, a filter or `format` is not valid, or
`limit` is not a whole number of at least 1. A `limit` above 5,000 counts as 5,000.
- `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`.
- `402 plan_limit_reached`: the workspace has no export rows left this month. `error.refusal` carries
the code `FUNDING_EXPORT_ROWS_LIMIT_REACHED`. On Kenso Lifetime, it carries
`LIFETIME_FUNDING_RESULT_LIMIT_REACHED` when the license has no funding results left today. They reset at
00:00 UTC.
- `413 validation_failed`: the body is larger than 1 MB.
- `422 export_limit_exceeded`: more rounds match than the export may return. `details[0].count` is the
number that matched and `details[0].limit` the most this export could return.
- `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 and the `export` permission.

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

### 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 `FundingRoundExportResult`.

| Field | Type | Description |
| --- | --- | --- |
| `fundingRounds` | array of FundingRound | The exported rounds. |
| `total` | integer (int32) | How many rounds the export holds. |

### Request

```bash
curl -X POST "https://api.ken.so/v1/funding-rounds/search/export" \
  -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": []
          }
        ]
      }
    ],
    "total": 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. |

### 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. |
