All Subscribers

Retrieve a list of all subscribers (active and expired) for a specific account.

https://v1.apifansly.com

GET

/api/fansly/{accountId}/subscribers

Get Started

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

Path Parameters

accountId*

string

The internal ID of the connected Fansly account.

Query Parameters

status*

string

Must be set to "3,4" to return all subscribers (active and expired).

Use status=3,4 to return both active and expired subscribers.

curl -X GET "https://v1.apifansly.com/api/fansly/{accountId}/subscribers?status=3,4" \
  -H "x-api-key: YOUR_API_KEY"

fetch("https://v1.apifansly.com/api/fansly/{accountId}/subscribers?status=3,4", {
  method: "GET",
  headers: {
    "x-api-key": "YOUR_API_KEY"
  }
})

import requests

url = "https://v1.apifansly.com/api/fansly/{accountId}/subscribers"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {"status": "3,4"}

response = requests.get(url, headers=headers, params=params)
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/{accountId}/subscribers?status=3,4"))
        .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/{accountId}/subscribers?status=3,4");
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/{accountId}/subscribers?status=3,4"
    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))
}

Response

{
    "statusCode": 200,
    "message": "Success",
    "data": {
        "status_code": 200,
        "data": {
            "success": true,
            "response": {
                "stats": {
                    "totalActive": 1,
                    "totalExpired": 1,
                    "total": 2
                },
                "subscriptions": [
                    {
                        "id": "XXxxxxxxxxxxxxxxxxxx",
                        "historyId": "XXxxxxxxxxxxxxxxxxxx",
                        "subscriberId": "XXxxxxxxxxxxxxxxxxxx",
                        "subscriptionTierId": "XXxxxxxxxxxxxxxxxxxx",
                        "subscriptionTierName": "1 month",
                        "subscriptionTierColor": "#46A7F8",
                        "planId": "XXxxxxxxxxxxxxxxxxxx",
                        "promoId": "0",
                        "giftCodeId": null,
                        "paymentMethodId": "0",
                        "status": 3,
                        "price": 5000,
                        "renewPrice": 5000,
                        "renewCorrelationId": "XXxxxxxxxxxxxxxxxxxx",
                        "autoRenew": 1,
                        "billingCycle": 30,
                        "duration": 30,
                        "renewDate": 1772732970000,
                        "version": 3,
                        "createdAt": 1772732970000,
                        "updatedAt": 1772732970000,
                        "endsAt": 1775411370000,
                        "promoPrice": null,
                        "promoDuration": null,
                        "promoStatus": null,
                        "promoStartsAt": null,
                        "promoEndsAt": null
                    },
                    {
                        "id": "XXxxxxxxxxxxxxxxxxxx",
                        "historyId": "XXxxxxxxxxxxxxxxxxxx",
                        "subscriberId": "XXxxxxxxxxxxxxxxxxxx",
                        "subscriptionTierId": "XXxxxxxxxxxxxxxxxxxx",
                        "subscriptionTierName": "1 month",
                        "subscriptionTierColor": "#46A7F8",
                        "planId": "XXxxxxxxxxxxxxxxxxxx",
                        "promoId": "0",
                        "giftCodeId": null,
                        "paymentMethodId": "0",
                        "status": 4,
                        "price": 5000,
                        "renewPrice": 5000,
                        "renewCorrelationId": "XXxxxxxxxxxxxxxxxxxx",
                        "autoRenew": 0,
                        "billingCycle": 30,
                        "duration": 30,
                        "renewDate": 1772732970000,
                        "version": 3,
                        "createdAt": 1772732970000,
                        "updatedAt": 1772732970000,
                        "endsAt": 1775411370000,
                        "promoPrice": null,
                        "promoDuration": null,
                        "promoStatus": null,
                        "promoStartsAt": null,
                        "promoEndsAt": null
                    }
                ]
            }
        }
    },
    "timestamp": "2026-03-16T02:06:25.512Z"
}

Response Fields

Field	Type	Description
`statusCode`	`number`	The HTTP status code of the response
`message`	`string`	Result status message
`data`	`object`	Main response payload
`├─ data`	`object`	Fansly specific data
`│ └─ response`	`object`	Subscribers payload
`│ ├─── stats`	`object`	Aggregated subscription counts
`│ │ ├─── totalActive`	`number`	Number of currently active subscriptions
`│ │ ├─── totalExpired`	`number`	Number of expired subscriptions
`│ │ └─── total`	`number`	Total number of subscriptions
`│ └─── subscriptions`	`array`	Array of all subscription objects
`│ ├─── id`	`string`	Unique subscription ID
`│ ├─── historyId`	`string`	Subscription history record ID
`│ ├─── subscriberId`	`string`	Fansly account ID of the subscriber
`│ ├─── subscriptionTierId`	`string`	ID of the subscription tier
`│ ├─── subscriptionTierName`	`string`	Display name of the tier
`│ ├─── subscriptionTierColor`	`string`	Hex color associated with the tier
`│ ├─── planId`	`string`	ID of the billing plan
`│ ├─── promoId`	`string`	Promo ID, `"0"` if none
`│ ├─── giftCodeId`	`string \| null`	Gift code ID if gifted, otherwise `null`
`│ ├─── paymentMethodId`	`string`	Payment method ID, `"0"` if none
`│ ├─── status`	`number`	Subscription status — `3` active, `4` expired
`│ ├─── price`	`number`	Subscription price (in cents)
`│ ├─── renewPrice`	`number`	Renewal price (in cents)
`│ ├─── autoRenew`	`number`	`1` if auto-renew is enabled, `0` if not
`│ ├─── billingCycle`	`number`	Billing cycle length in days
`│ ├─── duration`	`number`	Subscription duration in days
`│ ├─── renewDate`	`number`	Unix timestamp (ms) of the next renewal
`│ ├─── createdAt`	`number`	Unix timestamp (ms) when subscription was created
`│ ├─── updatedAt`	`number`	Unix timestamp (ms) of last update
`│ ├─── endsAt`	`number`	Unix timestamp (ms) when subscription ends or ended
`│ ├─── promoPrice`	`number \| null`	Promotional price if applicable
`│ ├─── promoDuration`	`number \| null`	Promotional duration in days if applicable
`│ ├─── promoStatus`	`number \| null`	Promotional status code if applicable
`│ ├─── promoStartsAt`	`number \| null`	Promo start timestamp if applicable
`│ └─── promoEndsAt`	`number \| null`	Promo end timestamp if applicable
`timestamp`	`string`	ISO 8601 timestamp of the response

Get Started

Path Parameters

Query Parameters

Response

Response Fields

On this page