---
title: "List the public bases you follow."
method: GET
path: "/api/following"
---

# List the public bases you follow.

`GET /api/following`

## Request

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

Requires a personal account or personal API key. Following grants no private access. Up to 50 hosted public bases per account. Updates show the latest published version of each document, not a version history. Repeated publication of the same version creates no update. Each read checks current publication. Unfollowing removes all notices for that base. Responses use private, no-store. No email or push messages.
Returns: { items[{id,name,available,followed_at,public_url}], total, limit }

## Response `200`

{ items[{id,name,available,followed_at,public_url}], total, limit }

- object
  - `items` FollowedBase[], required: The bounded personal library, at most 50 entries.
    - `id` string, required: The hosted base ID: 64 lowercase hexadecimal characters.
    - `name` string, nullable, required: Current public name; null when the base is unavailable.
    - `available` boolean, required: Whether the base is currently public.
    - `followed_at` string, required: When this account started following, ISO 8601.
    - `public_url` string, nullable, required: Current public page, or null when unavailable.
  - `total` integer, required: Followed count, including unavailable bases.
  - `limit` integer, required: Always 50.

## Other responses

- `400`: Invalid cursor.
- `401`: Sign in or use a personal API key.
- `403`: Organization keys cannot use a personal library.
- `404`: Base or following entry is inaccessible.
- `405`: Method not allowed.
- `409`: The account already follows 50 bases.
- `503`: The library is 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)