> 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

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

Search companies by their funding rounds and export the results.

Prospecting data. 5 endpoints under `https://api.ken.so`. Every request sends `Authorization: Bearer <your API key>` and `Ken-Version: 2026-11-02`: see [Authentication](/docs/authentication.md), [Workspaces](/docs/workspaces.md) and [Errors](/docs/errors.md). OpenAPI for this resource only: [/docs/api/funding-rounds/openapi.json](/docs/api/funding-rounds/openapi.json).

- `GET /v1/funding-rounds/{fundingRoundId}` - Get a funding round (`funding-rounds.get`): [/docs/api/funding-rounds/get.md](/docs/api/funding-rounds/get.md)
- `POST /v1/funding-rounds/search` - Search funding rounds (`funding-rounds.search`): [/docs/api/funding-rounds/search.md](/docs/api/funding-rounds/search.md)
- `POST /v1/funding-rounds/search/export` - Export funding rounds (`funding-rounds.export`): [/docs/api/funding-rounds/export.md](/docs/api/funding-rounds/export.md)
- `GET /v1/funding-rounds/export-allowance` - Get the funding round export allowance (`funding-rounds.get-export-allowance`): [/docs/api/funding-rounds/get-export-allowance.md](/docs/api/funding-rounds/get-export-allowance.md)
- `POST /v1/funding-rounds/filters/resolve` - Resolve filter values (`funding-rounds.resolve-filters`): [/docs/api/funding-rounds/resolve-filters.md](/docs/api/funding-rounds/resolve-filters.md)

## Get a funding round

`GET /v1/funding-rounds/{fundingRoundId}` - operationId `funding-rounds.get`

| Permission | Rate limit |
| --- | --- |
| Search view | 12,000 requests a minute per API key |

Get one funding round with its company, the people named on it, and `history`: the earlier rounds of the
same offering, oldest first.

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

Errors:

- `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`.
- `404 not_found`: no round has this id, or the id is not in the `fr_` format.
- `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/GET/v1/funding-rounds/%7BfundingRoundId%7D)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `fundingRoundId` | path | string | yes | The round's id: `fr_` followed by 18 digits. |
| `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 `FundingRoundDetail`.

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | The round's id: `fr_` followed by 18 digits. |
| `reportedAt` | string | The day the round was reported, as `yyyy-MM-dd`. |
| `firstSaleAt` | string | The day of the round's first sale, as `yyyy-MM-dd`. Null when unknown. |
| `isNewRound` | boolean | True when this is the first report of a new round, false for a later update of a round. |
| `amountRaisedUsd` | integer (int64) | 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) | The total sold in the round so far, in whole US dollars. Null when unknown. |
| `roundSizeUsd` | integer (int64) | The round's target size in whole US dollars. Null when the round is open-ended or the size is unknown. |
| `isOpenEnded` | boolean | True when the round has no set size. |
| `remainingUsd` | integer (int64) | The amount the round still offers, in whole US dollars. Null when unknown. |
| `minimumInvestmentUsd` | integer (int64) | The smallest investment the round accepts, in whole US dollars. Null when unknown. |
| `investorCount` | integer (int32) | How many investors have put money into the round. Null when unknown. |
| `industry` | string | The company's industry as reported with the round, for example `Other Technology`. Null when unknown. |
| `revenueRange` | string | 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 | The company that raised the round. |
| `people` | array of FundingRoundPerson | The people named on the round, without the organizations named on it. |
| `history` | array of FundingRoundHistoryEntry | The round's other reports, oldest first, without this one. |

### Request

```bash
curl -X GET "https://api.ken.so/v1/funding-rounds/fr_482913570264819357" \
  -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": {
    "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": [
          "executive_officer"
        ]
      }
    ],
    "history": [
      {
        "id": "fr_482913570264819357",
        "reportedAt": "string",
        "isNewRound": true,
        "amountRaisedUsd": 1,
        "roundRaisedUsd": 1
      }
    ]
  }
}
```

## 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
        }
      ]
    }
  }
}
```

## 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
  }
}
```

## Get the funding round export allowance

`GET /v1/funding-rounds/export-allowance` - operationId `funding-rounds.get-export-allowance`

| Permission | Rate limit |
| --- | --- |
| Search view | 12,000 requests a minute per API key |

Get how many funding round rows the workspace may still export this calendar month. Check it before a large
export.

The answer holds `limit`, `used` (rows exported this month, including exports still running),
`remaining`, `maxPerExport`, `isUnlimited`, and the month's `periodStart` and
`periodEnd`. The allowance resets on the first of each month, UTC. The call is free.

Errors:

- `503 service_unavailable`: Kenso could not read the allowance. Try again.

Requires Search view.

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

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

| Field | Type | Description |
| --- | --- | --- |
| `limit` | integer (int32) | Rows the workspace may export this month. |
| `used` | integer (int32) | Rows exported this month, including exports still running. |
| `remaining` | integer (int32) | Rows left this month. 2147483647 when `isUnlimited` is true. |
| `maxPerExport` | integer (int32) | The most rows one export can return. |
| `isUnlimited` | boolean | True when the workspace has no export limit. |
| `periodStart` | string (date-time) | The start of this calendar month, UTC. |
| `periodEnd` | string (date-time) | The start of next calendar month, UTC, when the allowance resets. |

### Request

```bash
curl -X GET "https://api.ken.so/v1/funding-rounds/export-allowance" \
  -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": {
    "limit": 1,
    "used": 1,
    "remaining": 1,
    "maxPerExport": 1,
    "isUnlimited": true,
    "periodStart": "2026-09-23T15:02:11Z",
    "periodEnd": "2026-09-23T15:02:11Z"
  }
}
```

## Resolve filter values

`POST /v1/funding-rounds/filters/resolve` - operationId `funding-rounds.resolve-filters`

| Permission | Rate limit |
| --- | --- |
| Search view | 4,800 requests a minute per API key |

Turn partial text into the exact values a funding round filter accepts, for type-ahead filter pickers.

Send `field` (`companies`, `industries`, `states` or `people`), `query` (the text
typed so far) and `limit`. The answer's `values` list holds each match's `value` to send as a
filter, its `label` to show, and its `count` of rounds.

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

Errors:

- `400 validation_failed`: `field` is unknown or a value is not valid.
- `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/filters/resolve)

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

| Field | Type | Description |
| --- | --- | --- |
| `values` | array of FundingRoundFilterValue | The matching values. |

### Request

```bash
curl -X POST "https://api.ken.so/v1/funding-rounds/filters/resolve" \
  -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": {
    "values": [
      {
        "value": "string",
        "label": "string",
        "count": 1
      }
    ]
  }
}
```

## Types

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

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

### FundingRoundHistoryEntry

An earlier or later report of the same round.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | no | The report's funding round id: `fr_` followed by 18 digits. |
| `reportedAt` | string | no | The day of the report, as `yyyy-MM-dd`. |
| `isNewRound` | boolean | no | True when this report opened the round. |
| `amountRaisedUsd` | integer (int64) | no | The money this report added, in whole US dollars. Null when unknown. |
| `roundRaisedUsd` | integer (int64) | no | The total sold in the round as of this report, in whole US dollars. Null when unknown. |

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

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

### FundingRoundFilterValue

One filter value that matches the text sent to resolve.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `value` | string | no | The value to send in the filter: for a company its domain, or its name when it has none. |
| `label` | string | no | The text to show for the value: a company's name, or the value itself. |
| `count` | integer (int64) | no | How many rounds have this value. |

All resources: [/docs.md](/docs.md).
