> ## 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 by date

> Returns funding rounds across all companies, newest first, each with the round detail and every participating investor (with a lead flag). Use each `investor_id` with [Get investor by ID](/api-reference/investors/get-investor-by-id) to pull a full investor profile.

<Note> Costs 1 credit per request, returning up to 50 results per page. </Note>

## What you need

Nothing beyond your API key — the feed spans every company. Narrow it with `announced_date_after` / `announced_date_before`, and walk it with `page` and `limit`.

## Behaviour

- Ordered by announced date, newest first, at most 50 results per page.
- Both date bounds are inclusive and each stands alone: send only `announced_date_after` for everything since a date, only `announced_date_before` for everything up to one, or both for a window.
- Every response carries `X-Total-Count`, `X-Page`, `X-Page-Size`, `X-Total-Pages` and a `Link` header, so you can size a range before paging through it.
- A range with no rounds returns `200` with an empty array, and an empty page is not billed.

## What you do next

- **Pull the company that raised.** Take `company_id` to [Get company by ID](/api-reference/companies/get-company-by-id).
- **Pull the investors.** Each entry in `investors` carries an `investor_id` for [Get investor by ID](/api-reference/investors/get-investor-by-id), and a lead flag so you can tell who led the round.
- **Poll for new rounds.** Re-run with `announced_date_after` set to your last poll date to collect only what has been announced since.




## OpenAPI

````yaml /api-ref/bundle_api.yaml get /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: 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:
  /funding-rounds:
    get:
      tags:
        - Transactions
      summary: Get funding rounds by date
      description: >
        Returns funding rounds across all companies, newest first, each with the
        round detail and every participating investor (with a lead flag). Use
        each `investor_id` with [Get investor by
        ID](/api-reference/investors/get-investor-by-id) to pull a full investor
        profile.


        <Note> Costs 1 credit per request, returning up to 50 results per page.
        </Note>


        ## What you need


        Nothing beyond your API key — the feed spans every company. Narrow it
        with `announced_date_after` / `announced_date_before`, and walk it with
        `page` and `limit`.


        ## Behaviour


        - Ordered by announced date, newest first, at most 50 results per page.

        - Both date bounds are inclusive and each stands alone: send only
        `announced_date_after` for everything since a date, only
        `announced_date_before` for everything up to one, or both for a window.

        - Every response carries `X-Total-Count`, `X-Page`, `X-Page-Size`,
        `X-Total-Pages` and a `Link` header, so you can size a range before
        paging through it.

        - A range with no rounds returns `200` with an empty array, and an empty
        page is not billed.


        ## What you do next


        - **Pull the company that raised.** Take `company_id` to [Get company by
        ID](/api-reference/companies/get-company-by-id).

        - **Pull the investors.** Each entry in `investors` carries an
        `investor_id` for [Get investor by
        ID](/api-reference/investors/get-investor-by-id), and a lead flag so you
        can tell who led the round.

        - **Poll for new rounds.** Re-run with `announced_date_after` set to
        your last poll date to collect only what has been announced since.
      operationId: getFundingRoundsByDate
      parameters:
        - in: query
          name: announced_date_after
          required: false
          schema:
            type: string
            format: date
            example: '2026-06-01'
          description: >
            Only return rounds announced on or after this date (`YYYY-MM-DD`,
            inclusive).
        - in: query
          name: announced_date_before
          required: false
          schema:
            type: string
            format: date
            example: '2026-06-30'
          description: >
            Only return rounds announced on or before this date (`YYYY-MM-DD`,
            inclusive).
        - $ref: '#/components/parameters/PaginationPage'
        - $ref: '#/components/parameters/PagePaginationLimit'
      responses:
        '200':
          description: A page of funding rounds.
          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'
        '429':
          $ref: '#/components/responses/RateLimits'
components:
  parameters:
    PaginationPage:
      in: query
      name: page
      schema:
        type: number
      required: false
      description: The page number of results to return, base 0, default is 0.
    PagePaginationLimit:
      in: query
      name: limit
      schema:
        type: integer
        minimum: 1
        maximum: 50
        default: 50
      required: false
      description: >
        The number of results to return per page (minimum 1, maximum 50, default
        50). A page is the unit these endpoints are priced in, so it cannot be
        widened beyond 50.
  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
    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

````