Payouts

Get Chargebacks Chart

Returns a daily timeseries of chargebacks over a date window — one series of summed chargeback amounts (chartAmount) and one series of row counts (chartCount) — alongside the window's total and the delta versus the prior equal-length window. Backs the line/bar chart on the OnlyFans Statistics → Chargebacks page. Requires permission api_payouts_read_chargebacks_chart.

https://public-api.fansmetric.com

GET/v1/{account_id}/payouts/chargebacks/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 UTC day in the window (inclusive of start_date and end_date). Emitted even when count is 0.
data.chartAmount[].datestring
ISO 8601 midnight UTC for the bucket day.
data.chartAmount[].countnumber
Sum of chargeback amounts filed that day, in the account's payout currency. The field is named count upstream — it represents dollars here.
data.chartCount[]array
One bucket per UTC day in the window. Same length and date keys as chartAmount.
data.chartCount[].datestring
ISO 8601 midnight UTC for the bucket day.
data.chartCount[].countnumber
Number of chargeback rows filed that day.
data.totalnumber
Sum of chartAmount[].count over the window — total chargeback dollars in the period.
data.deltanumber
total minus the total of the immediately preceding window of the same length. Positive = chargebacks grew vs. prior period; negative = shrank.
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 UTC day in the window (inclusive of `start_date` and `end_date`). Emitted even when `count` is `0`.
data.chartAmount[].date	string	ISO 8601 midnight UTC for the bucket day.
data.chartAmount[].count	number	Sum of chargeback amounts filed that day, in the account's payout currency. The field is named `count` upstream — it represents dollars here.
data.chartCount[]	array	One bucket per UTC day in the window. Same length and date keys as `chartAmount`.
data.chartCount[].date	string	ISO 8601 midnight UTC for the bucket day.
data.chartCount[].count	number	Number of chargeback rows filed that day.
data.total	number	Sum of `chartAmount[].count` over the window — total chargeback dollars in the period.
data.delta	number	`total` minus the total of the immediately preceding window of the same length. Positive = chargebacks grew vs. prior period; negative = shrank.
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/chargebacks/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-12-10T00:00:00+00:00"
"count":0
}
1:{"date":"2025-12-11T00:00:00+00:00"
"count":68.87
}
2:{"date":"2025-12-12T00:00:00+00:00"
"count":0
}
]
"chartCount":[0:{"date":"2025-12-10T00:00:00+00:00"
"count":0
}
1:{"date":"2025-12-11T00:00:00+00:00"
"count":1
}
2:{"date":"2025-12-12T00:00:00+00:00"
"count":0
}
]
"total":8398.35
"delta":926.7
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Get Chargeback Ratio

Get Payouts Chart