---
title: "List the IDs of your favorite bundles."
method: GET
path: "/api/favorites"
---

# List the IDs of your favorite bundles.

`GET /api/favorites`

## Request

- Base URL: `https://okfindex.com`
- URL: `https://okfindex.com/api/favorites`
- Auth: none declared

Private to the personal account. Up to 200 favorites. No bundle content is copied. Responses use private, no-store.
Returns: { ids, total, limit }

## Response `200`

{ ids, total, limit }

- object
  - `ids` string[], required: Saved IDs, at most 200.
  - `total` integer, required: Saved count.
  - `limit` integer, required: Always 200.

## Other responses

- `401`: Sign in or use a personal API key.
- `403`: Use a personal account.
- `404`: Bundle is not live.
- `409`: The account has 200 favorites.
- `503`: Favorites are unavailable.

---

[API](https://skmtc.dev/okfindex/apis/okf-index.md) · [All operations](https://skmtc.dev/okfindex/apis/okf-index/llms.txt) · [OpenAPI document](https://skmtc.dev/okfindex/apis/okf-index/revisions/4b13ca3c739f?raw)