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.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_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.
Response Fields
data.list[]arrayChargebacks in this page, newest first by
createdAt(filing date).data.list[].idintegerUpstream chargeback ID. Currently always
0in observed payloads — identify rows bypayment.id.data.list[].createdAtstringISO 8601 timestamp the chargeback was filed (not the original transaction).
data.list[].paymentTypestringCategory of the reversed transaction. Values:
post,chat_messages,tips,subscribes,stream.data.list[].paymentobjectOriginal transaction that was reversed. Same shape as an earnings transaction (
id,amount,vatAmount,taxAmount,mediaTaxAmount,fee,net,currency,createdAt,description,status,user).payment.status: "undo"marks the reversal.data.markerintegerSnapshot pin (unix seconds).
dataobject | arrayEndpoint-specific payload. See the fields below for this route.
_pagination.next_pagestringRelative URL for the next page, with the cursor or offset already applied. Append it to the API base URL and send it as-is. Omitted entirely on the last page.
_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.list[] | array | Chargebacks in this page, newest first by createdAt (filing date). |
| data.list[].id | integer | Upstream chargeback ID. Currently always 0 in observed payloads — identify rows by payment.id. |
| data.list[].createdAt | string | ISO 8601 timestamp the chargeback was filed (not the original transaction). |
| data.list[].paymentType | string | Category of the reversed transaction. Values: post, chat_messages, tips, subscribes, stream. |
| data.list[].payment | object | Original transaction that was reversed. Same shape as an earnings transaction (id, amount, vatAmount, taxAmount, mediaTaxAmount, fee, net, currency, createdAt, description, status, user). payment.status: "undo" marks the reversal. |
| data.marker | integer | Snapshot pin (unix seconds). |
| data | object | array | Endpoint-specific payload. See the fields below for this route. |
| _pagination.next_page | string | Relative URL for the next page, with the cursor or offset already applied. Append it to the API base URL and send it as-is. Omitted entirely on the last page. |
| _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/chargebacks?start_date=2026-01-01%2000%3A00%3A00&end_date=2026-01-31%2023%3A59%3A59&limit=20" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200