Social Fetch
Start for freeStart free
Ko-fi hub

Ko-fi Membership Tiers API

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

GET /v1/ko-fi/profiles/{handle}/tiers

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

Ko-fi Membership Tiers API 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.

Other Ko-fi endpoints