---
title: "List your custom indexes"
method: GET
path: "/v1/indexes"
---

# List your custom indexes

`GET /v1/indexes`

## Request

- Base URL: `https://api.typesearch.ai`
- URL: `https://api.typesearch.ai/v1/indexes`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

## Response `200`

Your indexes and your plan’s limits.

- IndexList
  - `object` 'list', required
  - `indexes` object[], required
    - `id` string, required
    - `object` 'index', required
    - `name` string, required
    - `status` 'active' | 'paused', required: paused: no credit left, so it is not re-read (nor billed) until there is.
    - `urls` object, required
      - `total` integer, required
      - `ready` integer, required
      - `pending` integer, required
      - `failed` integer, required
      - `blocked` integer, required
    - `sources` object[], required: Sitemaps and feeds: read every hour; new URLs are added (up to your limit) and updated ones re-read.
      - `url` string, required
      - `type` 'sitemap' | 'feed', required
      - `status` 'pending' | 'ok' | 'failed', required
      - `read_at` string, nullable, required
      - `urls` integer, required: URLs it listed the last time it was read.
      - `error` string, nullable, required
    - `cost_per_day_usd` number, required: What its URLs cost per day right now (US$2.00 per 1,000 URLs per month, a thirtieth per day).
    - `last_read_at` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
  - `limits` object, required: Your plan’s custom-index limits.
    - `urls` integer, nullable, required: URLs you can have across all your custom indexes; null is unlimited. Pay as you go 100, Monthly credit plan 10,000, Enterprise unlimited.
    - `urls_used` integer, required
    - `indexes` integer, nullable, required
    - `indexes_used` integer, required

## Other responses

- `402`: Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.
- `default`: Error (RFC 9457). In English unless the request sends `Accept-Language: es`.

---

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