> ## 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 all investor lists

> Returns the investor lists reachable from your API key: lists created via the API, lists with "Share to API" turned on, and global lists curated by Specter.

<Note> Free. This call does not consume credits. </Note>

## What you need

At least one investor list reachable from your API key. Create one in the Specter app (then share it with the API from the list's three-dot menu (⋯) by turning on "Share to API"), or via the API with [Create investor list](/api-reference/investor-lists/create-investor-list) (lists created via the API are shared automatically). Global lists curated by Specter are always reachable.

## Behaviour

- Each list object includes the number of investors in the list.
- Lists shared only within your team are not returned.
- To retrieve the investor IDs in a list, call [Get investor list](/api-reference/investor-lists/get-investor-list) with that list's ID.

## What you do next

- **Open a list's investors.** Get the investor IDs via [Get investor list](/api-reference/investor-lists/get-investor-list), or full profiles via [Get investor list results](/api-reference/investor-lists/get-investor-list-results).
- **Build a new list.** Create one with [Create investor list](/api-reference/investor-lists/create-investor-list).




## OpenAPI

````yaml /api-ref/bundle_api.yaml get /lists/investors
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:
  /lists/investors:
    get:
      tags:
        - Investor Lists
      summary: Get all investor lists
      description: >
        Returns the investor lists reachable from your API key: lists created
        via the API, lists with "Share to API" turned on, and global lists
        curated by Specter.


        <Note> Free. This call does not consume credits. </Note>


        ## What you need


        At least one investor list reachable from your API key. Create one in
        the Specter app (then share it with the API from the list's three-dot
        menu (⋯) by turning on "Share to API"), or via the API with [Create
        investor list](/api-reference/investor-lists/create-investor-list)
        (lists created via the API are shared automatically). Global lists
        curated by Specter are always reachable.


        ## Behaviour


        - Each list object includes the number of investors in the list.

        - Lists shared only within your team are not returned.

        - To retrieve the investor IDs in a list, call [Get investor
        list](/api-reference/investor-lists/get-investor-list) with that list's
        ID.


        ## What you do next


        - **Open a list's investors.** Get the investor IDs via [Get investor
        list](/api-reference/investor-lists/get-investor-list), or full profiles
        via [Get investor list
        results](/api-reference/investor-lists/get-investor-list-results).

        - **Build a new list.** Create one with [Create investor
        list](/api-reference/investor-lists/create-investor-list).
      operationId: get-investor-lists
      responses:
        '200':
          $ref: '#/components/responses/InvestorsListsResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimits'
components:
  responses:
    InvestorsListsResponse:
      description: The investor lists
      content:
        application/json:
          schema:
            type: array
            items:
              type: object
              properties:
                id:
                  description: List Id
                  type: string
                  format: uuid
                  example: dae1aa2c-abfb-41ae-b226-9e6db1e62694
                name:
                  description: Name of the list
                  type: string
                  example: PE Firms + Search Funds
                created_at:
                  description: Date (YYYY:MM:DD) the list was created.
                  type: string
                  format: date-time
                  example: '2025-02-13T11:47:39.519590Z'
                updated_at:
                  description: Date (YYYY:MM:DD) the list was last updated.
                  type: string
                  format: date-time
                  example: '2025-02-13T11:47:39.519590Z'
                investor_count:
                  description: The number of investors in this list
                  type: integer
                  example: 63
              required:
                - id
                - name
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/ApiKeyMissing'
              - $ref: '#/components/schemas/ApiKeyNotValid'
    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
  schemas:
    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
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````