> ## Documentation Index
> Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get funding rounds saved search results
> Returns the funding rounds matching a saved funding rounds search.
Costs 1 credit per result returned.
## What you need
A funding-rounds saved-search ID shared with the API; get one from [Get all saved
searches](/api-reference/saved-searches/get-all-saved-searches), or check counts
first with [Get funding rounds saved
search](/api-reference/funding-rounds-saved-searches/get-funding-rounds-saved-search).
## Behaviour
- Each item is the same funding round object [Get funding rounds by
date](/api-reference/transactions/get-funding-rounds-by-date) returns, so it
parses identically.
- The saved search must be shared with the API (via "Share to API") or be a global
search curated by Specter.
- Set `new_results_after` to a timestamp to return only the rounds added to the
search since then — pass back the timestamp of your last read to poll for what is
new. It must be within the last 60 days.
- Must be a funding rounds search, otherwise `400` with `NOT_SUPPORTED_PRODUCT`.
- `searchId` must be a number, otherwise `400` (`BAD_SEARCH_ID_TYPE`); returns `404`
if the search doesn't exist.
- A search that matches nothing returns `200` with an empty array, and is not
charged.
## What you do next
- **Get the full company.** Follow a `company_id` to [Get company by
ID](/api-reference/companies/get-company-by-id) for the complete profile.
- **Open a single round.** Pass a funding round ID to [Get funding round by
ID](/api-reference/transactions/get-funding-round-by-id).
## OpenAPI
````yaml /api-ref/openapi.json get /searches/funding-rounds/{searchId}/results
openapi: 3.1.0
info:
title: Specter API
termsOfService: https://tryspecter.com/terms/
contact:
name: API support
email: api-support@tryspecter.com
version: 1.0.0
servers:
- url: https://app.tryspecter.com/api/v1
description: Production
security:
- ApiKeyAuth: []
tags:
- name: Enrich
description: >-
Look up a company, person, or investor and, if Specter does not already
hold it, fetch it on demand. Includes email-based person enrichment.
- name: Search
description: Find records across every product from a single plain-English query.
- name: Companies
description: >-
Company profiles, funding, headcount, traction, the per-company signals
and sub-resources attached to a single company, and identifier resolution.
- name: People
description: >-
Specter people records: profile data, contact details, and per-person
lookups for a known person ID.
- name: Investors
description: >-
Specter investor records: profile, activity, targeting, funds, portfolio
companies, and the funding rounds they have participated in.
- name: Transactions
description: 'Transaction detail by ID: funding rounds, acquisitions, and IPOs.'
- name: Revenue Signals
description: >-
Revenue and profitability signals: by ID, by date, and for a saved list or
company search.
- name: Talent Signals
description: 'Talent signals: by ID and in bulk by ID.'
- name: Investor Interest Signals
description: 'Investor interest signals: by ID and in bulk by ID.'
- name: Company Lists
description: Create, query, and maintain lists of companies, including their results.
- name: Investor Lists
description: Create, query, and maintain lists of investors, including their results.
- name: People Lists
description: Create, query, and maintain lists of people, including their results.
- name: Saved Searches
description: List and delete searches saved via tryspecter.com.
- name: Company Saved Searches
description: Details and results for saved company searches.
- name: People Saved Searches
description: Details and results for saved people searches.
- name: Investor Saved Searches
description: Details and results for saved investor searches.
- name: Talent Signals Saved Searches
description: Details and results for saved Talent Signals searches.
- name: Investor Interest Saved Searches
description: Details and results for saved Investor Interest Signals searches.
- name: Funding Rounds Saved Searches
description: Details and results for saved funding-round searches.
- name: Acquisitions Saved Searches
description: Details and results for saved acquisition searches.
- name: IPOs Saved Searches
description: Details and results for saved IPO searches.
- name: Network
description: >-
Your team's LinkedIn network: the people and companies your teammates are
connected to, and your reach into a given company.
- name: Account
description: >-
Organisation-level resources: your team's members, API call logs, and
credit balance.
paths:
/searches/funding-rounds/{searchId}/results:
get:
tags:
- Funding Rounds Saved Searches
summary: Get funding rounds saved search results
description: >-
Returns the funding rounds matching a saved funding rounds search.
Costs 1 credit per result returned.
## What you need
A funding-rounds saved-search ID shared with the API; get one from [Get
all saved
searches](/api-reference/saved-searches/get-all-saved-searches), or
check counts
first with [Get funding rounds saved
search](/api-reference/funding-rounds-saved-searches/get-funding-rounds-saved-search).
## Behaviour
- Each item is the same funding round object [Get funding rounds by
date](/api-reference/transactions/get-funding-rounds-by-date) returns, so it
parses identically.
- The saved search must be shared with the API (via "Share to API") or
be a global
search curated by Specter.
- Set `new_results_after` to a timestamp to return only the rounds added
to the
search since then — pass back the timestamp of your last read to poll for what is
new. It must be within the last 60 days.
- Must be a funding rounds search, otherwise `400` with
`NOT_SUPPORTED_PRODUCT`.
- `searchId` must be a number, otherwise `400` (`BAD_SEARCH_ID_TYPE`);
returns `404`
if the search doesn't exist.
- A search that matches nothing returns `200` with an empty array, and
is not
charged.
## What you do next
- **Get the full company.** Follow a `company_id` to [Get company by
ID](/api-reference/companies/get-company-by-id) for the complete profile.
- **Open a single round.** Pass a funding round ID to [Get funding round
by
ID](/api-reference/transactions/get-funding-round-by-id).
operationId: getFundingRoundsSearchResults
parameters:
- name: searchId
in: path
required: true
schema:
type: string
description: The ID of the saved search being requested.
title: Searchid
description: The ID of the saved search being requested.
- name: limit
in: query
required: false
schema:
type: integer
maximum: 5000
minimum: 1
description: >-
The number of results to return per page (minimum 1, maximum 5000,
default 50).
default: 50
title: Limit
description: >-
The number of results to return per page (minimum 1, maximum 5000,
default 50).
- name: page
in: query
required: false
schema:
type: integer
minimum: 0
description: The page number of results to return, base 0, default is 0.
default: 0
title: Page
description: The page number of results to return, base 0, default is 0.
- name: new_results_after
in: query
required: false
schema:
anyOf:
- type: string
format: date-time
- type: 'null'
description: >-
Only return records added to the search on or after this moment,
e.g. `2026-07-10T00:00:00Z`. Must be within the last 60 days.
title: New Results After
description: >-
Only return records added to the search on or after this moment,
e.g. `2026-07-10T00:00:00Z`. Must be within the last 60 days.
responses:
'200':
description: A page of funding rounds.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PublicFundingRound'
title: Response Getfundingroundssearchresults
'400':
$ref: '#/components/responses/BadSearchIdTypeOrNotSupportedProduct'
'401':
$ref: '#/components/responses/ApiKeyMissingOrApiKeyNotValid'
'402':
$ref: '#/components/responses/OutOfCredits'
'403':
$ref: '#/components/responses/NotPermitted'
'404':
$ref: '#/components/responses/NotFound'
'422':
$ref: >-
#/components/responses/ValidationFailedOrNewResultsAfterBeyondRetention
'429':
$ref: '#/components/responses/RateLimited'
components:
schemas:
PublicFundingRound:
properties:
funding_round_id:
type: string
title: Funding Round Id
description: The Specter funding round ID.
examples:
- fnr_6ac8f4058536c08a85f052e7
name:
type: string
title: Name
description: The display name of the funding round.
examples:
- Angel Round - Best Apps Market
company_id:
anyOf:
- type: string
- type: 'null'
title: Company Id
description: The Specter company ID of the company that raised this round.
examples:
- 5e3a8fc7040ca7b0c6f35b14
company_name:
type: string
title: Company Name
description: The name of the company that raised this round.
examples:
- Best Apps Market
investment_type:
anyOf:
- type: string
- type: 'null'
title: Investment Type
description: The investment type for this round.
examples:
- Angel
announced_on:
anyOf:
- type: string
format: date
- type: 'null'
title: Announced On
description: The date (YYYY-MM-DD) the round was announced.
examples:
- '2011-05-10'
raised_amount_usd:
anyOf:
- type: number
- type: 'null'
title: Raised Amount Usd
description: The amount raised in USD.
examples:
- 65000000
pre_money_valuation_usd:
anyOf:
- type: number
- type: 'null'
title: Pre Money Valuation Usd
description: The reported pre-money valuation in USD.
examples:
- 3400000000
post_money_valuation_usd:
anyOf:
- type: number
- type: 'null'
title: Post Money Valuation Usd
description: The reported post-money valuation in USD.
examples:
- 3800000000
investors:
items:
$ref: '#/components/schemas/BasicInvestorInfo'
type: array
title: Investors
description: All investors that participated in this round.
type: object
required:
- funding_round_id
- name
- company_name
title: PublicFundingRound
BasicInvestorInfo:
properties:
investor_id:
type: string
title: Investor Id
description: The Specter investor ID.
examples:
- inv_5b4918f3cbdcda9dbf829bc3
investor_name:
type: string
title: Investor Name
description: The legal or brand name of the investor or investment firm.
examples:
- Anurag (Anu) Nigam
is_lead_investor:
type: boolean
title: Is Lead Investor
description: Whether this investor led the funding round.
examples:
- false
type: object
required:
- investor_id
- investor_name
- is_lead_investor
title: BasicInvestorInfo
description: A single investor's participation in a funding round.
BadSearchIdType:
properties:
errorCode:
type: string
const: BAD_SEARCH_ID_TYPE
title: Errorcode
message:
type: string
title: Message
examples:
- The search id needs to be a number.
type: object
required:
- errorCode
- message
title: BadSearchIdType
NotSupportedProduct:
properties:
errorCode:
type: string
const: NOT_SUPPORTED_PRODUCT
title: Errorcode
message:
type: string
title: Message
description: >-
The product that was requested and the product the operation
supports.
examples:
- >-
The product "people" is not supported by this operation. Only
"companies" are supported.
type: object
required:
- errorCode
- message
title: NotSupportedProduct
ApiKeyMissing:
properties:
errorCode:
type: string
const: API_KEY_MISSING
title: Errorcode
message:
type: string
title: Message
examples:
- No API Key was presented on the header X-API-KEY
type: object
required:
- errorCode
- message
title: ApiKeyMissing
ApiKeyNotValid:
properties:
errorCode:
type: string
const: API_KEY_NOT_VALID
title: Errorcode
message:
type: string
title: Message
examples:
- API key present, but not valid
type: object
required:
- errorCode
- message
title: ApiKeyNotValid
OutOfCredits:
properties:
errorCode:
type: string
enum:
- OUT_OF_CREDITS
- DAILY_CREDIT_CAP_REACHED
title: Errorcode
description: >-
`OUT_OF_CREDITS` when the organization's credit pool is empty;
`DAILY_CREDIT_CAP_REACHED` when the organization's own daily credit
limit has been reached, which clears at 00:00 UTC.
message:
type: string
title: Message
examples:
- There are no more credits available to complete the request
type: object
required:
- errorCode
- message
title: OutOfCredits
NotPermitted:
properties:
errorCode:
type: string
const: NOT_PERMITTED
title: Errorcode
message:
type: string
title: Message
examples:
- API key present, but you are not permitted
type: object
required:
- errorCode
- message
title: NotPermitted
NotFound:
properties:
errorCode:
type: string
const: NOT_FOUND
title: Errorcode
message:
type: string
title: Message
examples:
- Not Found
type: object
required:
- errorCode
- message
title: NotFound
ValidationFailed:
properties:
errorCode:
type: string
const: VALIDATION_ERROR
title: Errorcode
message:
type: string
title: Message
description: >-
Why the request was rejected: each invalid field, with the path to
it.
examples:
- Field required (body.name)
type: object
required:
- errorCode
- message
title: ValidationFailed
NewResultsAfterBeyondRetention:
properties:
errorCode:
type: string
const: NEW_RESULTS_AFTER_BEYOND_RETENTION
title: Errorcode
message:
type: string
title: Message
examples:
- '`new_results_after` must be within the last 60 days.'
type: object
required:
- errorCode
- message
title: NewResultsAfterBeyondRetention
RateLimited:
properties:
errorCode:
type: string
const: RATE_LIMITED
title: Errorcode
message:
type: string
title: Message
examples:
- You have been rate-limited
type: object
required:
- errorCode
- message
title: RateLimited
responses:
BadSearchIdTypeOrNotSupportedProduct:
description: BadRequest
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/BadSearchIdType'
- $ref: '#/components/schemas/NotSupportedProduct'
ApiKeyMissingOrApiKeyNotValid:
description: Unauthorized
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/ApiKeyMissing'
- $ref: '#/components/schemas/ApiKeyNotValid'
OutOfCredits:
description: Out of credits - API credit limit exceeded
headers:
X-CreditLimit-Limit:
description: The total number of credits allocated for the current period
schema:
type: integer
X-CreditLimit-Remaining:
description: The number of credits remaining for the current period
schema:
type: integer
X-CreditLimit-Reset:
description: The number of seconds until the credit limit resets
schema:
type: number
format: float
X-CreditLimit-Daily-Limit:
description: >-
The organization's own daily credit limit. Sent only when one is
set.
schema:
type: integer
X-CreditLimit-Daily-Remaining:
description: >-
The credits left under the daily limit today. Sent only when one is
set.
schema:
type: integer
X-CreditLimit-Daily-Reset:
description: >-
The number of seconds until the daily limit resets at 00:00 UTC.
Sent only when one is set.
schema:
type: number
format: float
content:
application/json:
schema:
$ref: '#/components/schemas/OutOfCredits'
NotPermitted:
description: Forbidden - There is no permissions to use the endpoint
content:
application/json:
schema:
$ref: '#/components/schemas/NotPermitted'
NotFound:
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/NotFound'
ValidationFailedOrNewResultsAfterBeyondRetention:
description: >-
`new_results_after` is older than the 60-day change-retention window
(`NEW_RESULTS_AFTER_BEYOND_RETENTION`), or is not a valid timestamp.
content:
application/json:
schema:
anyOf:
- $ref: '#/components/schemas/ValidationFailed'
- $ref: '#/components/schemas/NewResultsAfterBeyondRetention'
RateLimited:
description: Too Many Requests - API Rate limit exceeded
headers:
X-RateLimit-Limit:
description: The total rate limit allowed for this endpoint
schema:
type: integer
X-RateLimit-Remaining:
description: The number of requests remaining
schema:
type: integer
X-RateLimit-Reset:
description: The number of seconds until the rate limit resets
schema:
type: number
format: float
content:
application/json:
schema:
$ref: '#/components/schemas/RateLimited'
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.