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*
stringThe 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
| Field | Type | Description |
|---|---|---|
statusCode | number | The HTTP status code of the response (e.g., 200) |
message | string | A human-readable message about the result |
data | object | The main response payload |
├─ status_code | number | The internal status code of the Fansly operation |
└─ data | object | Nested data container |
├─ success | boolean | Indicates whether the request was successful |
└─ response | array | A list of subscription tiers |
├─ id | string | The unique identifier for the tier |
├─ accountId | string | The account ID that owns the tier |
├─ name | string | The name of the tier |
├─ color | string | The hex color code associated with the tier |
├─ pos | number | The display position/order of the tier |
├─ price | number | The base price of the tier, in cents |
├─ maxSubscribers | number | The maximum number of subscribers allowed on this tier, or 0 for unlimited |
├─ subscriptionBenefits | array | A list of benefits associated with the tier |
├─ includedTierIds | array | IDs of other tiers included/bundled with this one |
└─ plans | array | A list of billing plans available for the tier |
├─ id | string | The unique identifier for the plan |
├─ status | number | The status of the plan (e.g., 1 for active) |
├─ billingCycle | number | The billing cycle length, in days |
├─ price | number | The price of the plan, in cents |
├─ useAmounts | number | Internal usage counter for the plan |
└─ promos | array | A list of active promotions for the plan |
timestamp | string | The ISO 8601 timestamp of when the response was generated |