---
title: "List indexes"
method: GET
path: "/indexes"
tags: ["Indexes"]
---

# List indexes

`GET /indexes`

## Request

- Base URL: `https://theindex.fyi/api`
- URL: `https://theindex.fyi/api/indexes`
- Auth: none declared

Returns a paginated, filterable list of all active indexes.

## Query parameters

- `filter[category]` 'curated_directories' | 'rss_feed_aggregators' | 'search_engines' | 'random_discovery' | 'constraint_based_clubs' | 'indieweb_infrastructure'
- `filter[language]` string
- `page[number]` integer
- `page[size]` integer

## Response `200`

A paginated collection of index resources.

- IndexCollection
  - `data` IndexResourceObject[], required
    - `type` 'indexes', required
    - `id` string, required: Unique numeric ID as a string, per JSON:API spec.
    - `attributes` IndexAttributes, required
      - `name` string, required: Display name of the index.
      - `slug` string, required: URL-safe unique identifier.
      - `url` string, uri, required: The index's URL.
      - `description` string, required: One-sentence description of what the index is and who it's for.
      - `category` 'curated_directories' | 'rss_feed_aggregators' | 'search_engines' | 'random_discovery' | 'constraint_based_clubs' | 'indieweb_infrastructure', required: The category this index belongs to.
      - `language` string, nullable: ISO 639-1 language code of the index's primary language. Null if English or unknown.
      - `accepts_submissions` boolean, required: Whether this index accepts submissions from the public.
      - `last_checked_at` string, date-time, nullable: When the link was last verified as live.
    - `links` object, required
      - `self` string, uri, required
  - `meta` object, required
    - `total` integer, required: Total number of matching indexes across all pages.
    - `per_page` integer, required
    - `current_page` integer, required
    - `last_page` integer, required
  - `links` object, required
    - `self` string, uri, required
    - `first` string, uri, required
    - `last` string, uri, required
    - `prev` string, uri, nullable
    - `next` string, uri, nullable

## Other responses

- `429`: Rate limit exceeded. Wait for the `Retry-After` period before retrying.

---

[API](https://skmtc.dev/theindex/apis/theindex-fyi.md) - [All operations](https://skmtc.dev/theindex/apis/theindex-fyi/llms.txt) - [OpenAPI document](https://skmtc.dev/theindex/apis/theindex-fyi/revisions/8907574c4f12?raw)