---
title: "Tracked investors"
method: GET
path: "/api/v1/investors"
tags: ["Investors"]
---

# Tracked investors

`GET /api/v1/investors`

## Request

- Base URL: `https://foliofact.com`
- URL: `https://foliofact.com/api/v1/investors`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `/oauth/authorize`, token URL `/oauth/token`)

Investor roster with featured fund and top holding.

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Paginated investor roster

- InvestorRoster
  - `investors` object[], required
    - `slug` string, required
    - `name` string, required
    - `kind` 'person' | 'organization', required
    - `fund` object, nullable, required
      - `slug` string, required
      - `name` string, required
    - `quarter` string, nullable, required
    - `report_period_on` string, date, nullable, required
    - `positions` integer, nullable, required
    - `total_value` integer, nullable, required: Latest 13F portfolio value in whole US dollars.
    - `top_holding` object, nullable, required
      - `ticker` string, required
      - `name` string, nullable, required
  - `pagination` Pagination, required
    - `page` integer, required
    - `per_page` integer, required
    - `total` integer, required
    - `total_pages` integer, required

## Other responses

- `429`: Rate limit exceeded
- `default`: Structured error

---

[API](https://skmtc.dev/foliofact/apis/foliofact-api.md) · [All operations](https://skmtc.dev/foliofact/apis/foliofact-api/llms.txt) · [OpenAPI document](https://skmtc.dev/foliofact/apis/foliofact-api/revisions/a92e927f23f4?raw)