FMFansMetric API

Payouts

Get Chargeback Ratio

Returns the account's chargeback ratio (chargebacks divided by gross sales) over a date window. To compute the ratio over the entire account lifetime, pass /me/start-date as start_date. Requires permission api_payouts_read_chargebacks_ratio.

https://public-api.fansmetric.com
GET/v1/{account_id}/payouts/chargebacks/ratio
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

    Window start. Default 2 years ago, UTC.

  • end_datestring

    Window end. Default end of today, UTC.

Response Fields

  • data.chargebacksRationumber

    Chargeback ratio as a decimal (e.g. 0.14 = 14%) over the requested window.

  • 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.

curl --request GET "https://public-api.fansmetric.com/v1/100000001/payouts/chargebacks/ratio?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":{
"chargebacksRatio":0.14
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

Get Payout Eligibility

Next

Get Chargebacks Chart