> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/search/funding-rounds/individual-lookup.md).

# Individual Lookup

Find companies that just raised money and get them back right away.

<mark style="color:green;">`POST`</mark> `/funding_search`

{% hint style="info" %}
Costs **1 credit per funding round returned**. A company that raised twice in the window is one company with two rounds, so it costs 2 credits. If your balance covers fewer rounds than `max_results`, the search still runs for as many rounds as your balance covers, charges that, and `message` says so. Only a balance under 1 credit, too low for even one round, is refused with `402`. A search that finds nothing is free.
{% endhint %}

Returns companies that recently announced a funding round and match your filters, in the response. Nothing is saved. To save the companies into a list, or keep a list topped up with new rounds, use [List Lookup](https://developer.parvenu.io/search/funding-rounds/list-lookup.md).

{% hint style="warning" %}
**Two filters leave rows out.** With `country` (or `state`) set, rounds whose headquarters cannot be read are left out. With `max_amount_usd` set, rounds with no amount are left out.
{% endhint %}

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name                   | Type             | Description                                                                                                                                                                                                         |
| ---------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `api_key`              | string           | **Required.** Your API key.                                                                                                                                                                                         |
| `stages`               | array of strings | Optional. Round types to include: `pre_seed`, `seed`, `pre_a`, `series_a`, `series_b`, `series_c`, `series_d_plus`, `growth`, `bridge`, `convertible`, `secondary`. Empty means all of them.                        |
| `include_other_rounds` | boolean          | Optional, defaults to `true`. Also includes debt, grants, undisclosed and other round types, rounds not yet confirmed by their sources, and raises still in progress. Set `false` for confirmed equity rounds only. |
| `sectors`              | array of strings | Optional. Up to 20 sectors, e.g. `["ai", "fintech"]`. Empty means all of them.                                                                                                                                      |
| `country`              | string           | Optional. Headquarters country, e.g. `"United States"`.                                                                                                                                                             |
| `state`                | string           | Optional. US state, e.g. `"Georgia"` or `"GA"`. Setting it also means the United States.                                                                                                                            |
| `min_amount_usd`       | integer          | Optional. Smallest round, in US dollars, e.g. `1000000`.                                                                                                                                                            |
| `max_amount_usd`       | integer          | Optional. Largest round, in US dollars.                                                                                                                                                                             |
| `investor`             | string           | Optional. Only rounds with this investor, as a lead or other investor.                                                                                                                                              |
| `keyword`              | string           | Optional. Matched against the company name or description.                                                                                                                                                          |
| `lookback`             | string           | Optional. How far back to look: `today`, `7d` (default) or `30d`.                                                                                                                                                   |
| `max_results`          | integer          | Optional. Most rounds to return, 1 to 100. Default 25.                                                                                                                                                              |

**Response**

See [Response Format](https://developer.parvenu.io/getting-started/response-format.md) for the fields every endpoint returns.

| Field               | Description                                                                         |
| ------------------- | ----------------------------------------------------------------------------------- |
| `data`              | The companies found. One entry per company, with its rounds under `funding_rounds`. |
| `total`             | Number of companies returned.                                                       |
| `rounds`            | Number of rounds returned. This is what you are billed for.                         |
| `credits_per_row`   | Credits per round (`1`).                                                            |
| `credits_used`      | Credits charged for this call.                                                      |
| `credits_remaining` | Your balance after the call.                                                        |

Each company in `data` has:

| Field                       | Description                                                         |
| --------------------------- | ------------------------------------------------------------------- |
| `organization_name`         | Company name.                                                       |
| `domain`                    | Website domain, e.g. `strella.io`.                                  |
| `company_website`           | Website URL.                                                        |
| `company_linkedin_url`      | LinkedIn company page.                                              |
| `industry`                  | Industry.                                                           |
| `headquarters`              | `raw` (as written), `state`, `country` and `country_code`.          |
| `company_description`       | Short description.                                                  |
| `company_logo`              | Logo URL.                                                           |
| `funding_rounds`            | The matching rounds (see below).                                    |
| `latest_funding_stage`      | The newest round's type in plain words, e.g. `"Series A"`.          |
| `latest_funding_amount_usd` | The newest round's amount in US dollars. `null` when not announced. |
| `latest_funding_date`       | The newest round's date (`YYYY-MM-DD`).                             |
| `latest_funding_investors`  | The newest round's investors, comma separated, leads first.         |

Each round in `funding_rounds` has:

| Field             | Description                                   |
| ----------------- | --------------------------------------------- |
| `round_id`        | The round's id.                               |
| `stage`           | Round type code, e.g. `series_a`.             |
| `stage_label`     | Round type in plain words, e.g. `"Series A"`. |
| `amount_usd`      | Amount in US dollars, or `null`.              |
| `announced_on`    | Date announced (`YYYY-MM-DD`).                |
| `lead_investors`  | List of lead investors.                       |
| `other_investors` | List of other investors.                      |
| `source_url`      | Link to the announcement, or `null`.          |

**Example**

{% tabs %}
{% tab title="Input" %}

```json
{
  "api_key": "your_api_key",
  "country": "United States",
  "max_results": 1
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": [
    {
      "organization_name": "Strella",
      "domain": "strella.io",
      "company_website": "https://strella.io",
      "company_linkedin_url": "https://www.linkedin.com/company/strella-io",
      "industry": "AI",
      "headquarters": {
        "raw": "Seattle",
        "state": "Washington",
        "country": "United States",
        "country_code": "us"
      },
      "company_description": "the AI-powered Customer Research Platform",
      "company_logo": "https://cdn.prod.website-files.com/66c895d91c6ea7b93745b98c/66fe625628ede03fd126f527_Strella-Black-Logo.avif",
      "funding_rounds": [
        {
          "round_id": "strella:other:2026-10-23",
          "stage": "series_a",
          "stage_label": "Series A",
          "amount_usd": 4250000,
          "announced_on": "2026-10-23",
          "lead_investors": ["SilverBlue"],
          "other_investors": ["LeVert Ventures", "PeakBridge", "Beta Milouot"],
          "source_url": null
        }
      ],
      "latest_funding_stage": "Series A",
      "latest_funding_amount_usd": 4250000,
      "latest_funding_date": "2026-10-23",
      "latest_funding_investors": "SilverBlue, LeVert Ventures, PeakBridge, Beta Milouot"
    }
  ],
  "credits_used": 1.0,
  "credits_remaining": 3400.5,
  "total": 1,
  "rounds": 1,
  "credits_per_row": 1.0,
  "message": null,
  "success": true
}
```

{% endtab %}
{% endtabs %}

{% hint style="success" %}
Try `max_results: 1` first to see the shape of the data. It costs at most 1 credit.
{% endhint %}
