Payouts

Get Payouts Chart

Returns the payout-requests timeseries that backs the OnlyFans Statements → Payout Requests page — one $ series (chartAmount), one request-count series (chartCount), the window's total, 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_payouts_read_chart.

https://public-api.fansmetric.com

GET/v1/{account_id}/payouts/chart

API keyBearer

Authorization

default

AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

account_id*integer
OnlyFans numeric account ID.

Query Parameters

start_datestring
Window start. Default 2 years ago, UTC. YYYY-MM-DD HH:MM:SS or ISO 8601 (the T separator is normalized to a space).
end_datestring
Window end. Default end of today, UTC. Same format as start_date.

Response Fields

data.chartAmount[]array
One bucket per period in the window. date is midnight UTC ISO 8601 at the bucket start; count is the $ paid out in that bucket, in the account's payout currency.
data.chartCount[]array
Same bucket alignment as chartAmount. count is the number of payout requests in that bucket.
data.totalnumber
Sum of chartAmount[].count over the window — total $ paid out in the period.
data.deltanumber
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").
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_meta._credits.usedinteger
Credits consumed by this request (currently always 1).
_meta._rate_limits.limit_minuteinteger
Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteinteger
Remaining requests in the current minute window.
_meta._rate_limits.limit_dayinteger
Maximum requests per day for the organization.
_meta._rate_limits.remaining_dayinteger
Remaining 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 $ paid out in that bucket, in the account's payout currency.
data.chartCount[]	array	Same bucket alignment as `chartAmount`. `count` is the number of payout requests in that bucket.
data.total	number	Sum of `chartAmount[].count` over the window — total $ paid out in the period.
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/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

{"data":{"chartAmount":[0:{"date":"2025-09-01T00:00:00+00:00"
"count":0
}
1:{"date":"2025-10-01T00:00:00+00:00"
"count":150000
}
]
"chartCount":[0:{"date":"2025-09-01T00:00:00+00:00"
"count":0
}
1:{"date":"2025-10-01T00:00:00+00:00"
"count":12
}
]
"total":1362957
"delta":100
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Get Chargebacks Chart

List Payout Requests