> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/mastodon/profiles-handle-collections>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/mastodon/profiles-handle-collections.mdx>

---

# Mastodon Collections API

An account's curated collections, with their member accounts, on servers new enough to offer them.

`GET /v1/mastodon/profiles/{handle}/collections` resolves the account and returns its curated collections. Each entry in `data.collections` carries `id`, `name`, `description`, `language`, `hashtag`, `url`, `uri`, `isDiscoverable`, `isSensitive`, `itemCount`, `createdAt`, `updatedAt` and an `items` list. Each item has `id`, `state`, `accountId`, `createdAt` and, when available, the full member `account`.

Collections arrived in Mastodon 4.7. Older servers and forks that do not implement the route return `lookupStatus: unsupported` with an empty list, not `not_found`. The route fills in up to 40 distinct member accounts; when those accounts are temporarily unavailable the collections still return and a warning says the members were not filled.

## Request

- **Endpoint:** `GET /v1/mastodon/profiles/{handle}/collections`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by handle
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/mastodon/profiles/handle/collections/get)
- **Platform page:** [/platforms/mastodon](https://www.socialfetch.dev/platforms/mastodon)

## FAQ

### Which servers return collections?

Servers running Mastodon 4.7 or later that have collections enabled. Older Mastodon servers and forks without the route return lookupStatus unsupported with an empty collections list.

### How many credits does it cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

### Are member accounts always filled?

Each item has accountId. The full account is filled when available. When it is not, the collections still come back and the response carries a parse warning, so account can be null.

### Does this endpoint page?

No. It returns the account's collections in one response. Use the profile, posts and follower routes for the account's other data.