Skip to content
ProspectAPIs

API reference / Funding

Search funding rounds

Written and maintained by The ProspectAPIs team

GET/v1/funding

GET /v1/funding is the ProspectAPIs operation searchFunding, in the Funding group of the REST API. Keyset-paginated funding rounds, newest first. Costs one record per record returned, after the monthly free allowance; a search that matches nothing is free. Pass next_cursor back as cursor for the next page. If the balance ends a page early the response carries X-Result-Capped: balance and next_cursor still continues exactly after the last record served. Cost: $0.02 per record, after 100 free a month. Send your API key as a Bearer token in the Authorization header.

How this fits with the rest of the funding API, with worked examples, is in the funding signals guide.

Parameters

Parameters of GET /v1/funding
NameInTypeDescription
sincequerystring (date)Only rounds announced on or after this date (inclusive), YYYY-MM-DD.
untilquerystring (date)Only rounds announced on or before this date (inclusive), YYYY-MM-DD.
roundquerystringOne or more round stages, comma-separated (1 to 20), such as seed,series_a.
min_amount_usdquerynumberOnly rounds of at least this USD amount.
max_amount_usdquerynumberOnly rounds of at most this USD amount.
companyquerystringCase-insensitive substring match on the company name (1 to 100 characters).
domainquerystringExact company domain, a bare domain such as example.com.
investorquerystringRounds that include this investor (exact, case-insensitive).
countryquerystringHeadquarters country. A country name or any two-letter ISO 3166-1 code (United States, US, Germany, DE) matches country_code exactly; any other text, such as a city, matches the stated location (country), case-insensitive.
limitqueryintegerPage size, 1 to 100 (default 25).
cursorquerystringThe previous page's next_cursor, passed back unchanged.

An unknown query parameter is refused with a 400 rather than ignored, so a typo never widens a search you pay for.

Responses

Response codes of GET /v1/funding
StatusMeaning
200A page of funding rounds.
400The request was invalid (e.g. a bad filter or input); nothing was charged.
401The API key is missing or invalid.
402Out of credits and free records. The body carries top_up_url.
429Too many requests; retry after the window.

Every error answers with the same JSON body, an error string and sometimes a code; the errors page lists each status and when it happens. A per-key 429 carries Retry-After; see rate limits.

200 response fields

A page of funding rounds. The body is a FundingList.

Fields of the 200 response
FieldTypeDescription
data requiredarray of FundingRecordA single funding round. Fields that are unknown for a round are null.
data[].id requiredstring (uuid)
data[].company_name requiredstring
data[].company_domainstring or null
data[].event_classstring or nullThe kind of event, e.g. a funding round.
data[].round_labelstring or nullThe human round label, e.g. "Series A".
data[].round_stagestring or nullThe normalised round stage, e.g. "series_a" (the value round filters on).
data[].amount_usdnumber or nullThe round size in USD, when known.
data[].amount_originalnumber or nullThe round size in its original currency, when it was not USD.
data[].currencystring or nullThe original currency code for amount_original.
data[].announced_at requiredstring (date)The announcement date (the sort key).
data[].investorsarray of string or null
data[].lead_investorsarray of string or null
data[].countrystring or nullThe headquarters location as the source states it, often a city or a state.
data[].country_codestring or nullThe headquarters country as an ISO 3166-1 alpha-2 code, such as US. Null when the location is unknown, ambiguous or names two countries.
data[].source_urlstring (uri) or nullThe public announcement a buyer verifies against.
data[].attributesobject or nullExtra, source-dependent fields.
data[].updated_atstring (date-time) or null
next_cursor requiredstring or nullPass back as cursor for the next page; null on the last page.
count requiredintegerHow many records this page holds.
Response headers
HeaderMeaning
X-Credits-RemainingUSD credits left after this call settles.
X-Free-Records-RemainingFree records left this month after this call settles.
X-Result-CappedPresent and set to balance when the page was shortened to what the balance pays for. The data has more rows; pass next_cursor to continue.

Code samples

Each sample sends the same request. Set PROSPECTAPIS_KEY in your environment first. Values come from the spec's examples; replace them with your own.

curl
curl -G https://api.prospectapis.com/v1/funding \
  -H "Authorization: Bearer $PROSPECTAPIS_KEY" \
  --data-urlencode "since=2026-10-01" \
  --data-urlencode "round=seed,series_a" \
  --data-urlencode "limit=10"
JavaScript (fetch)
const params = new URLSearchParams({ since: "2026-10-01", round: "seed,series_a", limit: "10" });
const res = await fetch(`https://api.prospectapis.com/v1/funding?${params}`, {
  headers: { Authorization: `Bearer ${process.env.PROSPECTAPIS_KEY}` },
});
if (!res.ok) throw new Error(`${res.status}: ${(await res.json().catch(() => ({}))).error ?? res.statusText}`);
const data = await res.json();
console.log(data);
Python (requests)
import os, requests

res = requests.get(
    "https://api.prospectapis.com/v1/funding",
    headers={"Authorization": f"Bearer {os.environ['PROSPECTAPIS_KEY']}"},
    params={"since": "2026-10-01", "round": "seed,series_a", "limit": 10},
    timeout=30,
)
res.raise_for_status()
data = res.json()
print(data)

Billing

Billing reserves before it serves: the call holds what it may cost, serves at most what that hold covers, and refunds the rest when the response closes. Any non-2xx answer refunds the whole hold, so a failed call costs nothing. The response reports your balance in X-Credits-Remaining.

The funding signals guide covers this area end to end. Next operation: Read one funding round. Every operation, grouped by area, is on the API reference index.

Create a free account to get a key, then run the samples above with your own values.

Was this page helpful?