OnlyFans API icon

OnlyFans API

Consume the OnlyFans API

Actions147

Fans → List Expired Fans

AI-generated

Summary

Retrieve a list of expired fans for a specified OnlyFans account, optionally filtering by criteria such as subscription duration, tips, total spent, online status, and pagination parameters.

Inputs

  • Account ID (required) — The ID of the OnlyFans account whose expired fans will be listed.
  • Additional Fields — Optional filters to refine the list of expired fans, including filter keyword, limit (1-50) of fans per response, minimum subscription duration in days, minimum tips amount, minimum total spent, offset for pagination, online status filter (1 for online), and fan type (default 'expired').

Output shape

a list of fan records matching the expired fans criteria

The list respects the optional filter parameters and pagination (limit and offset). Each item represents an expired fan's data returned by the OnlyFans API.

Examples

Example 1: List expired fans of account '12345' with minimum subscription duration of 30 days and limit of 20 fans.

Set Account ID to '12345', Additional Fields: Minimum Subscription Duration (Days) to '30', Limit to '20'.

Discussion