Payouts
List Payout Requests
Returns the history of withdrawal requests the creator has submitted — one row per request, with invoice ID, amount, currency, approval state, and reject reason. This is the payout-history view, not the per-transaction earnings feed. Requires permission api_payouts_list_requests.
https://public-api.fansmetric.comGET/v1/{account_id}/payouts/requests
Bearer
Authorization
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_datestringLower bound on
createdAt. Default 2 years ago, UTC.end_datestringUpper bound on
createdAt. Default end of today, UTC.offsetintegerRows to skip. Page size is fixed at 10.
markerstringSnapshot pin (unix seconds) from a prior response. Omit on the first page; pass back unchanged so the paged view stays stable.
curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/payouts/requests?start_date=sample_start_date&end_date=sample_end_date&offset=0" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"list":[
0:{
"invoiceId":"84452061"
"createdAt":"2026-04-20T09:34:59+00:00"
"amount":20000
"currency":"USD"
"state":"approved"
"rejectReason":null
}
]
"marker":1779973920
}
"_pagination":{
"next_page":"/v1/523213896/payouts/requests?offset=10&marker=1779973920"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}