Payouts
List Chargebacks
Returns the chargeback history — disputes the fan's bank reversed against the creator. Each row carries the original transaction details under a nested payment object, so no cross-reference against the earnings feed is needed. Requires permission api_payouts_list_chargebacks.
https://public-api.buffmetrics.comGET/v1/{account_id}/payouts/chargebacks
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 the chargeback's
createdAt(filing date, not original transaction). Default 2 years ago, UTC.end_datestringUpper bound on the chargeback's
createdAt. Default end of today, UTC.limitintegerPage size. Default 10. Min 1, max 100.
offsetintegerRows to skip.
markerstringSnapshot 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/payouts/chargebacks?start_date=sample_start_date&end_date=sample_end_date&limit=20" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"list":[
0:{
"id":0
"createdAt":"2026-05-15T03:15:33+00:00"
"paymentType":"post"
"payment":{
"id":"aa6c984b86eaf11a07442042e711c7f9"
"amount":23.99
"vatAmount":0
"taxAmount":0
"mediaTaxAmount":0
"net":19.19
"fee":4.8
"createdAt":"2026-05-10T03:46:25+00:00"
"currency":"USD"
"description":"Post purchase by <span>dino 762</span>"
"status":"undo"
"user":{
"id":540415984
"name":"dino 762"
"username":"u540415984"
"view":"t"
"isVerified":false
"isDeleted":false
"isActive":false
"avatar":null
"avatarThumbs":null
}
}
}
]
"marker":1779974073
}
"_pagination":{
"next_page":"/v1/523213896/payouts/chargebacks?limit=10&offset=10&marker=1779974073"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}