FMFansMetric API

Referrals

List Referral Payouts

Returns the monthly referral commission payouts the creator has received — one row per disbursement. Same shape as /payouts/requests but scoped to referral commissions, not earnings withdrawals. Requires permission api_referrals_list_payouts.

https://public-api.buffmetrics.com
GET/v1/{account_id}/referrals/payouts
Bearer

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

    Lower bound on createdAt. Default 2 years ago, UTC.

  • end_datestring

    Upper bound on createdAt. Default end of today, UTC.

  • offsetinteger

    Rows to skip. Page size is fixed at 10.

  • markerstring

    Snapshot pin (unix seconds) from a prior response. Omit on the first page; pass back unchanged on subsequent pages.

curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/referrals/payouts?start_date=sample_start_date&end_date=sample_end_date&offset=0" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"list":[
0:{
"invoiceId":"240825"
"createdAt":"2026-05-01T15:58:51+00:00"
"amount":739
"currency":"USD"
"state":"approved"
"rejectReason":null
}
]
"marker":1779974137
}
"_pagination":{
"next_page":null
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

Get Referral Balance

Next

Get Referral Payouts Chart