Earnings

List All Earnings

Returns the account's per-transaction earnings feed across all revenue streams combined — subscriptions, tips, PPV post purchases, paid messages, stream earnings. One row per payment. Filter to a single stream with type; narrow tips to a single surface with tips_source. Requires permission api_earnings_list.

https://public-api.fansmetric.com

GET/v1/{account_id}/earnings

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
Lower bound on createdAt. Default 2 years ago, UTC. Format YYYY-MM-DD HH:MM:SS or ISO 8601 (T is normalized to a space).
end_datestring
Optional upper bound on createdAt. Same format as start_date.
markerstring
Pagination cursor (unix seconds). Omit on the first page; pass the previous response's nextMarker for subsequent pages.
typestring
Revenue-stream filter. Values: subscribes, tips, post, chat_messages, stream. Omit for everything.
tips_sourcestring
Only meaningful when type=tips. Narrows to a single surface. Values: profile, post_all, chat, stream, story. Forwarded upstream as tipsSource.

Response Fields

data.list[]array
Transactions in this page, newest first.
data.list[].idstring
OnlyFans transaction ID (hex).
data.list[].amountnumber
Gross transaction amount in currency.
data.list[].vatAmountnumber
VAT collected from the fan.
data.list[].taxAmountnumber
Other tax withheld from the creator.
data.list[].mediaTaxAmountnumber
Media-specific tax withheld (digital-goods tax in some jurisdictions).
data.list[].feenumber
OnlyFans platform fee (typically 20% of amount).
data.list[].netnumber
Amount credited to the creator (amount − fee − taxes).
data.list[].currencystring
ISO 4217 currency code.
data.list[].createdAtstring
ISO 8601 transaction timestamp.
data.list[].descriptionstring
Human-readable label containing an HTML <a> to the paying fan. Common prefixes: Payment for message from …, Tip from …, Post purchase by …, Subscription from ….
data.list[].statusstring
Settlement status. loading while still in the payoutPendingDays hold; transitions to settled after.
data.list[].payoutPendingDaysinteger
Days the row stays pending before counting toward payoutAvailable.
data.list[].userobject
Paying fan: id, username, name, displayName, avatar, avatarThumbs.
data.markerinteger
Cursor used to fetch this page (unix seconds).
data.hasMoreboolean
Whether more pages remain.
data.nextMarkerinteger
Cursor for the next page. Absent on the last page.
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_pagination.next_pagestring
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.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.list[]	array	Transactions in this page, newest first.
data.list[].id	string	OnlyFans transaction ID (hex).
data.list[].amount	number	Gross transaction amount in `currency`.
data.list[].vatAmount	number	VAT collected from the fan.
data.list[].taxAmount	number	Other tax withheld from the creator.
data.list[].mediaTaxAmount	number	Media-specific tax withheld (digital-goods tax in some jurisdictions).
data.list[].fee	number	OnlyFans platform fee (typically 20% of `amount`).
data.list[].net	number	Amount credited to the creator (`amount − fee − taxes`).
data.list[].currency	string	ISO 4217 currency code.
data.list[].createdAt	string	ISO 8601 transaction timestamp.
data.list[].description	string	Human-readable label containing an HTML `<a>` to the paying fan. Common prefixes: `Payment for message from …`, `Tip from …`, `Post purchase by …`, `Subscription from …`.
data.list[].status	string	Settlement status. `loading` while still in the `payoutPendingDays` hold; transitions to settled after.
data.list[].payoutPendingDays	integer	Days the row stays pending before counting toward `payoutAvailable`.
data.list[].user	object	Paying fan: `id`, `username`, `name`, `displayName`, `avatar`, `avatarThumbs`.
data.marker	integer	Cursor used to fetch this page (unix seconds).
data.hasMore	boolean	Whether more pages remain.
data.nextMarker	integer	Cursor for the next page. Absent on the last page.
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/earnings?start_date=2026-01-01%2000%3A00%3A00&end_date=2026-01-31%2023%3A59%3A59&marker=sample_marker" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"list":[0:{"id":"fd1d0844b7129594ba045a5cf8045fc5"
"amount":19
"vatAmount":0
"taxAmount":0
"mediaTaxAmount":0
"net":15.2
"fee":3.8
"currency":"USD"
"createdAt":"2026-05-28T12:54:47+00:00"
"description":"Payment for message from <a href="https://onlyfans.com/u100000005">Fan XX</a>"
"status":"loading"
"payoutPendingDays":7
"user":{"id":100000005
"name":"Fan XX"
"username":"u100000005"
"displayName":"Fan XX"
"view":"t"
"isVerified":false
"isDeleted":false
"isActive":true
"avatar":null
"avatarThumbs":null
}
}
]
"marker":1779973132
"hasMore":true
"nextMarker":1779966690
}
"_pagination":{"next_page":"/v1/100000001/earnings?start_date=2025-09-17%2004%3A23%3A50&marker=1779966690"
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Get Earnings Chart

Chat Overview