Referrals
Get Referral Payouts Chart
Returns the referral-commission timeseries that backs the OnlyFans Statements → Referrals page — one $ series (chartAmount), one payout-count series (chartCount), net + gross totals, and OF's percent-change delta vs the previous equal-length window. Bucket granularity (daily vs monthly) is chosen by OnlyFans based on window length. Requires permission api_referrals_read_chart.
https://public-api.fansmetric.comAuthorization
defaultAuthorizationBearer <token>Send your FansMetric API key as a Bearer token in the Authorization header.
In: header
Path Parameters
account_id*integerOnlyFans numeric account ID.
Query Parameters
start_datestringWindow start. Default 2 years ago, UTC.
YYYY-MM-DD HH:MM:SSor ISO 8601 (theTseparator is normalized to a space).end_datestringWindow end. Default end of today, UTC. Same format as
start_date.
Response Fields
data.chartAmount[]arrayOne bucket per period in the window.
dateis midnight UTC ISO 8601 at the bucket start;countis the net referral commission $ in that bucket (after platform fees), in the account's payout currency.data.chartCount[]arraySame bucket alignment as
chartAmount.countis the number of referral payouts in that bucket.data.totalnumberNet referral commissions over the window — sum of
chartAmount[].count.data.grossnumberGross referral commissions over the window (before platform fees).
data.deltanumberOF-computed change vs the immediately preceding equal-length window. Reported as a whole-number percent and saturates at
100(treat ≥100 as "at least doubled").dataobject | arrayEndpoint-specific payload. See the fields below for this route.
_meta._credits.usedintegerCredits consumed by this request (currently always
1)._meta._rate_limits.limit_minuteintegerMaximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteintegerRemaining requests in the current minute window.
_meta._rate_limits.limit_dayintegerMaximum requests per day for the organization.
_meta._rate_limits.remaining_dayintegerRemaining requests in the current day window.
| Field | Type | Description |
|---|---|---|
| data.chartAmount[] | array | One bucket per period in the window. date is midnight UTC ISO 8601 at the bucket start; count is the net referral commission $ in that bucket (after platform fees), in the account's payout currency. |
| data.chartCount[] | array | Same bucket alignment as chartAmount. count is the number of referral payouts in that bucket. |
| data.total | number | Net referral commissions over the window — sum of chartAmount[].count. |
| data.gross | number | Gross referral commissions over the window (before platform fees). |
| data.delta | number | OF-computed change vs the immediately preceding equal-length window. Reported as a whole-number percent and saturates at 100 (treat ≥100 as "at least doubled"). |
| data | object | array | Endpoint-specific payload. See the fields below for this route. |
| _meta._credits.used | integer | Credits consumed by this request (currently always 1). |
| _meta._rate_limits.limit_minute | integer | Maximum requests per minute for the organization. |
| _meta._rate_limits.remaining_minute | integer | Remaining requests in the current minute window. |
| _meta._rate_limits.limit_day | integer | Maximum requests per day for the organization. |
| _meta._rate_limits.remaining_day | integer | Remaining requests in the current day window. |
curl --request GET "https://public-api.fansmetric.com/v1/100000001/referrals/payouts/chart?start_date=2026-01-01%2000%3A00%3A00&end_date=2026-01-31%2023%3A59%3A59" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200