Fansly API LogoFansly API
Subscription

Get Subscription Tiers

List all subscription tiers.

Get all subscription tiers, including pricing, billing cycle, and plan details for each tier. Useful for displaying available subscription options.

https://v1.apifansly.com/api/fansly
GET
/{account_id}/subscriptions/tiers

Get Started

All requests to the Fansly API require an API Key. See the Authentication page for details.

curl -X GET "https://v1.apifansly.com/api/fansly/{account_id}/subscriptions/tiers" \
  -H "x-api-key: YOUR_API_KEY"
fetch("https://v1.apifansly.com/api/fansly/{account_id}/subscriptions/tiers", {
  method: "GET",
  headers: {
    "x-api-key": "YOUR_API_KEY"
  }
})
import requests

url = "https://v1.apifansly.com/api/fansly/{account_id}/subscriptions/tiers"
headers = {
    "x-api-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://v1.apifansly.com/api/fansly/{account_id}/subscriptions/tiers"))
        .header("x-api-key", "YOUR_API_KEY")
        .GET()
        .build();

client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
        .thenApply(HttpResponse::body)
        .thenAccept(System.out::println)
        .join();
using System.Net.Http;
using System.Threading.Tasks;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var response = await client.GetAsync("https://v1.apifansly.com/api/fansly/{account_id}/subscriptions/tiers");
var responseString = await response.Content.ReadAsStringAsync();

Console.WriteLine(responseString);
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://v1.apifansly.com/api/fansly/{account_id}/subscriptions/tiers"
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("x-api-key", "YOUR_API_KEY")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Path Parameters

account_id*
string
The unique identifier for the connected account.

Response

{
    "statusCode": 200,
    "message": "Success",
    "data": {
        "status_code": 200,
        "data": {
            "success": true,
            "response": [
                {
                    "id": "tier_id_string",
                    "accountId": "account_id_string",
                    "name": "tier_name",
                    "color": "#FFD700",
                    "pos": 0,
                    "price": 5000,
                    "maxSubscribers": 0,
                    "subscriptionBenefits": [],
                    "includedTierIds": [],
                    "plans": [
                        {
                            "id": "plan_id_string",
                            "status": 1,
                            "billingCycle": 30,
                            "price": //tier_price,
                            "useAmounts": 0,
                            "promos": []
                        }
                    ]
                }
            ]
        }
    },
    "timestamp": "2026-06-18T18:11:15.826Z"
}

Response Body

FieldTypeDescription
statusCodenumberThe HTTP status code of the response (e.g., 200)
messagestringA human-readable message about the result
dataobjectThe main response payload
├─ status_codenumberThe internal status code of the Fansly operation
└─ dataobjectNested data container
├─ successbooleanIndicates whether the request was successful
└─ responsearrayA list of subscription tiers
├─ idstringThe unique identifier for the tier
├─ accountIdstringThe account ID that owns the tier
├─ namestringThe name of the tier
├─ colorstringThe hex color code associated with the tier
├─ posnumberThe display position/order of the tier
├─ pricenumberThe base price of the tier, in cents
├─ maxSubscribersnumberThe maximum number of subscribers allowed on this tier, or 0 for unlimited
├─ subscriptionBenefitsarrayA list of benefits associated with the tier
├─ includedTierIdsarrayIDs of other tiers included/bundled with this one
└─ plansarrayA list of billing plans available for the tier
├─ idstringThe unique identifier for the plan
├─ statusnumberThe status of the plan (e.g., 1 for active)
├─ billingCyclenumberThe billing cycle length, in days
├─ pricenumberThe price of the plan, in cents
├─ useAmountsnumberInternal usage counter for the plan
└─ promosarrayA list of active promotions for the plan
timestampstringThe ISO 8601 timestamp of when the response was generated

On this page