> ## 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 investor funding rounds
> Returns an investor's funding rounds, newest first. Each round carries the round detail, the company that raised, and the full list of participating investors - so you can see this investor's co-investors on every deal. Use `company_id` with [Get company by ID](/api-reference/companies/get-company-by-id), or any `investor_id` with [Get investor by ID](/api-reference/investors/get-investor-by-id).
Costs 1 credit per request.
## What you need
A Specter investor ID (`inv_…`).
## Behaviour
- Ordered by `announced_on` descending; rounds with no announced date come last.
- Page through results with `limit` and `page` (`page` is zero-based; `limit` defaults to 50, max 1000).
- Bound results by announced date with `funding_announced_date_after` / `funding_announced_date_before`.
- Returns `404` if the investor ID doesn't exist.
## What you do next
- **Open a company that raised.** Resolve any round's `company_id` with [Get company by ID](/api-reference/companies/get-company-by-id).
- **Profile a co-investor.** Pass any participating `investor_id` to [Get investor by ID](/api-reference/investors/get-investor-by-id).
## OpenAPI
````yaml /api-ref/bundle_api.yaml get /investors/{investorId}/funding-rounds
openapi: 3.0.0
info:
title: Specter API
termsOfService: https://tryspecter.com/terms/
contact:
name: API support
email: api-support@tryspecter.com
version: 1.0.0
servers:
- description: Production
url: https://app.tryspecter.com/api/v1
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: News Signals
description: |
Company-level news signals: by ID, and for a saved list or company search.
- 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: 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:
/investors/{investorId}/funding-rounds:
get:
tags:
- Investors
summary: Get investor funding rounds
description: >
Returns an investor's funding rounds, newest first. Each round carries
the round detail, the company that raised, and the full list of
participating investors - so you can see this investor's co-investors on
every deal. Use `company_id` with [Get company by
ID](/api-reference/companies/get-company-by-id), or any `investor_id`
with [Get investor by ID](/api-reference/investors/get-investor-by-id).
Costs 1 credit per request.
## What you need
A Specter investor ID (`inv_…`).
## Behaviour
- Ordered by `announced_on` descending; rounds with no announced date
come last.
- Page through results with `limit` and `page` (`page` is zero-based;
`limit` defaults to 50, max 1000).
- Bound results by announced date with `funding_announced_date_after` /
`funding_announced_date_before`.
- Returns `404` if the investor ID doesn't exist.
## What you do next
- **Open a company that raised.** Resolve any round's `company_id` with
[Get company by ID](/api-reference/companies/get-company-by-id).
- **Profile a co-investor.** Pass any participating `investor_id` to
[Get investor by ID](/api-reference/investors/get-investor-by-id).
parameters:
- $ref: '#/components/parameters/InvestorId'
- $ref: '#/components/parameters/PaginationLimit'
- $ref: '#/components/parameters/PaginationPage'
- in: query
name: funding_announced_date_after
required: false
schema:
type: string
format: date
example: '2026-06-01'
description: >
Only return funding rounds announced on or after this date
(`YYYY-MM-DD`, inclusive).
- in: query
name: funding_announced_date_before
required: false
schema:
type: string
format: date
example: '2026-06-30'
description: >
Only return funding rounds announced on or before this date
(`YYYY-MM-DD`, inclusive).
responses:
'200':
description: A paginated list of funding rounds the investor participated in.
headers:
X-Total-Count:
schema:
type: integer
description: >-
Total number of funding rounds for this investor across all
pages.
X-Page:
schema:
type: integer
description: The current 0-indexed page number.
X-Page-Size:
schema:
type: integer
description: The page size used to compute this response.
X-Total-Pages:
schema:
type: integer
description: The total number of pages available.
Link:
schema:
type: string
description: RFC 5988 pagination links (`next`, `prev`, `first`, `last`).
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PublicFundingRound'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/OutOfCredits'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimits'
components:
parameters:
InvestorId:
in: path
name: investorId
schema:
type: string
required: true
description: >-
The ID of the investor being requested (e.g.
`inv_5f3a2b1c4d5e6f7a8b9c0d1e`).
PaginationLimit:
in: query
name: limit
schema:
type: number
required: false
description: The number of results to return, default is 50.
PaginationPage:
in: query
name: page
schema:
type: number
required: false
description: The page number of results to return, base 0, default is 0.
schemas:
PublicFundingRound:
title: Funding Round
type: object
required:
- company_name
- funding_round_id
- name
additionalProperties: false
properties:
funding_round_id:
type: string
description: The Specter funding round ID.
example: fnr_6ac8f4058536c08a85f052e7
name:
type: string
description: The display name of the funding round.
example: Angel Round - Best Apps Market
company_id:
type: string
nullable: true
description: The Specter company ID of the company that raised this round.
example: 5e3a8fc7040ca7b0c6f35b14
company_name:
type: string
description: The name of the company that raised this round.
example: Best Apps Market
investment_type:
type: string
nullable: true
description: The investment type for this round.
enum:
- Angel
- Convertible Note
- Corporate Round
- Debt Financing
- Equity Crowdfunding
- Grant
- Initial Coin Offering
- Non Equity Assistance
- Post Ipo Debt
- Post Ipo Equity
- Post Ipo Secondary
- Pre Seed
- Private Equity
- Product Crowdfunding
- Secondary Market
- Seed
- Series A
- Series B
- Series C
- Series D
- Series E
- Series F
- Series G
- Series H
- Series I
- Series J
- Series Unknown
- Undisclosed
example: Angel
announced_on:
type: string
format: date
nullable: true
description: The date (YYYY-MM-DD) the round was announced.
example: '2011-05-10'
raised_amount_usd:
type: number
nullable: true
description: The amount raised in USD.
example: 65000000
pre_money_valuation_usd:
type: number
nullable: true
description: The reported pre-money valuation in USD.
example: 3400000000
post_money_valuation_usd:
type: number
nullable: true
description: The reported post-money valuation in USD.
example: 3800000000
investors:
type: array
description: All investors that participated in this round.
items:
$ref: '#/components/schemas/BasicInvestorInfo'
BasicInvestorInfo:
title: BasicInvestorInfo
type: object
description: A single investor's participation in a funding round.
required:
- investor_id
- investor_name
- is_lead_investor
additionalProperties: false
properties:
investor_id:
type: string
description: The Specter investor ID.
example: inv_5b4918f3cbdcda9dbf829bc3
investor_name:
type: string
description: The legal or brand name of the investor or investment firm.
example: Anurag (Anu) Nigam
is_lead_investor:
type: boolean
description: Whether this investor led the funding round.
example: false
ApiKeyMissing:
properties:
errorCode:
description: API_KEY_MISSING
example: API_KEY_MISSING
type: string
message:
description: No API Key was presented on the header X-API-KEY
example: No API Key was presented on the header X-API-KEY
type: string
ApiKeyNotValid:
properties:
errorCode:
description: API_KEY_NOT_VALID
example: API_KEY_NOT_VALID
type: string
message:
description: API key present, but not valid
example: API key present, but not valid
type: string
responses:
Unauthorized:
description: Unauthorized
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ApiKeyMissing'
- $ref: '#/components/schemas/ApiKeyNotValid'
OutOfCredits:
description: Out of credits - API credit limit exceeded
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
enum:
- OUT_OF_CREDITS
message:
type: string
description: |
There are no more credits available to complete the request.
headers:
X-CreditLimit-Limit:
schema:
type: integer
description: The total number of credits allocated for the current period
X-CreditLimit-Remaining:
schema:
type: integer
description: The number of credits remaining for the current period
X-CreditLimit-Reset:
schema:
type: number
format: float
description: The number of seconds until the credit limit resets
Forbidden:
description: Forbidden - There is no permissions to use the endpoint
content:
application/json:
schema:
type: object
properties:
errorCode:
description: NOT_PERMITTED
type: string
example: NOT_PERMITTED
message:
type: string
description: You do not have permission to access this resource.
example: You do not have permission to access this resource.
required:
- errorCode
- message
NotFound:
description: Not Found
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
description: NOT_FOUND
message:
type: string
description: Not Found
RateLimits:
description: Too Many Requests - API Rate limit exceeded
content:
application/json:
schema:
type: object
required:
- errorCode
- message
properties:
errorCode:
type: string
description: RATE_LIMITED
message:
type: string
description: You have been rate-limited
headers:
X-RateLimit-Limit:
schema:
type: integer
description: The total rate limit allowed for this endpoint
X-RateLimit-Remaining:
schema:
type: integer
description: The number of requests remaining
X-RateLimit-Reset:
schema:
type: number
format: float
description: The number of seconds until the rate limit resets
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
````