> **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/ko-fi/profiles-handle-tiers>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/ko-fi/profiles-handle-tiers.mdx>

---

# Ko-fi Membership Tiers API

A creator's membership levels, prices and benefits, ordered by monthly price.

`GET /v1/ko-fi/profiles/{handle}/tiers` returns `data.tiers`, sorted by ascending monthly price and then by name. Each tier has `id`, `name`, `pricePerMonth`, `description`, `benefits`, `spotsAvailable`, `images` and `activeMembers`. `data.currency` is the currency of the monthly prices. `data.membership.unlockable` gives the creator's totals for `posts`, `galleryItems`, `shopItems`, `commissions`, `discounts` and `polls` that a membership unlocks.

A creator with no membership returns `lookupStatus: found`, `membership: null` and an empty `tiers` list, which is different from a missing creator. A missing creator returns `not_found` with null identity fields and an empty list.

## Request

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

## FAQ

### What is the difference between a missing creator and no tiers?

A missing creator returns lookupStatus: not_found with id, handle and name null. A real creator with no membership returns lookupStatus: found, membership: null and tiers: []. Check lookupStatus before treating an empty list as a missing page.

### What does a tier include?

id, name, pricePerMonth, description, benefits, spotsAvailable, images and activeMembers. spotsAvailable is null when the tier has no limit. images are the tier's preview image URLs.

### Where does the currency come from?

data.currency is the currency of pricePerMonth, the currency of the creator's checkout. It can be null when the creator does not publish a currency.

### How many credits does a tiers lookup 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.