Skip to main content
GET
/
api
/
{account}
/
payouts
/
earning-statistics
List Earning Statistics
curl --request GET \
  --url https://app.onlyfansapi.com/api/{account}/payouts/earning-statistics \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "list": {
      "months": {
        "1735689661": {
          "tips": [
            {
              "time": 1735689661,
              "net": 4,
              "gross": 5
            }
          ],
          "total_net": 100,
          "total_gross": 125,
          "subscribes": [
            {
              "time": 1735689661,
              "net": 16,
              "gross": 20
            }
          ]
        }
      },
      "total": {
        "tips": {
          "total_net": 123.45,
          "total_gross": 123.45
        },
        "all": {
          "total_net": 123.45,
          "total_gross": 123.45
        },
        "subscribes": {
          "total_net": 123.45,
          "total_gross": 123.45
        },
        "chat_messages": {
          "total_net": 123.45,
          "total_gross": 123.45
        },
        "post": {
          "total_net": 123.45,
          "total_gross": 123.45
        }
      }
    }
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999842,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 999,
      "remaining_day": 49846
    }
  }
}

Authorizations

​
Authorization
string
header
required

You can retrieve your token by visiting the OnlyFansAPI Console and clicking API Keys -> Create API Key.

Path Parameters

​
account
string
required

The Account ID

Query Parameters

​
startDate
string | null

The start date for earning statistics. Keep empty to get all earnings.

Example:

"2025-01-01 00:00:00, -30days"

​
endDate
string | null

The end date for earning statistics. Keep empty to get all earnings.

Example:

"2025-01-01 00:00:00, +30days"

Response

200 - application/json
​
data
object
​
_meta
object