onlyfans 0.1.0 → 0.3.0

data/rbi/onlyfans/models/webhook_create_params.rbi

@@ -11,8 +11,9 @@ module Onlyfans
           T.any(Onlyfans::WebhookCreateParams, Onlyfans::Internal::AnyHash)
         end
 
-      # The account scope for the webhook. Use "global" for all accounts, "inclusive"
-      # for only selected accounts, or "exclusive" for all except selected accounts.
+      # The account scope for the webhook (OnlyFans and Fansly webhooks alike). Use
+      # "global" for all accounts, "inclusive" for only selected accounts, or
+      # "exclusive" for all except selected accounts.
       sig { returns(String) }
       attr_accessor :account_scope
 
@@ -21,12 +22,14 @@ module Onlyfans
       attr_accessor :endpoint_url
 
       # An array of webhook events to subscribe to. For all options, refer to our **List
-      # Available Events** endpoint.
+      # Available Events** endpoint. A webhook is single-platform: subscribe to either
+      # OnlyFans events or Fansly (`fansly.*`) events, never both in one webhook.
       sig { returns(T::Array[String]) }
       attr_accessor :events
 
-      # An array of account IDs to apply the scope to. Required unless account_scope is
-      # "global".
+      # An array of account IDs to apply the scope to. Use OnlyFans account IDs
+      # (`acct_...`) for OnlyFans webhooks and Fansly account IDs (`fansly_acct_...`)
+      # for Fansly webhooks. Required unless account_scope is "global".
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :account_ids
 
@@ -48,16 +51,19 @@ module Onlyfans
         ).returns(T.attached_class)
       end
       def self.new(
-        # The account scope for the webhook. Use "global" for all accounts, "inclusive"
-        # for only selected accounts, or "exclusive" for all except selected accounts.
+        # The account scope for the webhook (OnlyFans and Fansly webhooks alike). Use
+        # "global" for all accounts, "inclusive" for only selected accounts, or
+        # "exclusive" for all except selected accounts.
         account_scope:,
         # The URL of your webhook endpoint.
         endpoint_url:,
         # An array of webhook events to subscribe to. For all options, refer to our **List
-        # Available Events** endpoint.
+        # Available Events** endpoint. A webhook is single-platform: subscribe to either
+        # OnlyFans events or Fansly (`fansly.*`) events, never both in one webhook.
         events:,
-        # An array of account IDs to apply the scope to. Required unless account_scope is
-        # "global".
+        # An array of account IDs to apply the scope to. Use OnlyFans account IDs
+        # (`acct_...`) for OnlyFans webhooks and Fansly account IDs (`fansly_acct_...`)
+        # for Fansly webhooks. Required unless account_scope is "global".
         account_ids: nil,
         # Optionally, add a signing secret to protect your webhook.
         signing_secret: nil,

data/rbi/onlyfans/models/webhook_update_params.rbi

@@ -14,8 +14,9 @@ module Onlyfans
       sig { returns(String) }
       attr_accessor :webhook_id
 
-      # The account scope for the webhook. Use "global" for all accounts, "inclusive"
-      # for only selected accounts, or "exclusive" for all except selected accounts.
+      # The account scope for the webhook (OnlyFans and Fansly webhooks alike). Use
+      # "global" for all accounts, "inclusive" for only selected accounts, or
+      # "exclusive" for all except selected accounts.
       sig { returns(String) }
       attr_accessor :account_scope
 
@@ -24,12 +25,14 @@ module Onlyfans
       attr_accessor :endpoint_url
 
       # An array of webhook events to subscribe to. For all options, refer to our **List
-      # Available Events** endpoint.
+      # Available Events** endpoint. A webhook is single-platform: subscribe to either
+      # OnlyFans events or Fansly (`fansly.*`) events, never both in one webhook.
       sig { returns(T::Array[String]) }
       attr_accessor :events
 
-      # An array of account IDs to apply the scope to. Required unless account_scope is
-      # "global".
+      # An array of account IDs to apply the scope to. Use OnlyFans account IDs
+      # (`acct_...`) for OnlyFans webhooks and Fansly account IDs (`fansly_acct_...`)
+      # for Fansly webhooks. Required unless account_scope is "global".
       sig { returns(T.nilable(T::Array[String])) }
       attr_reader :account_ids
 
@@ -54,16 +57,19 @@ module Onlyfans
       end
       def self.new(
         webhook_id:,
-        # The account scope for the webhook. Use "global" for all accounts, "inclusive"
-        # for only selected accounts, or "exclusive" for all except selected accounts.
+        # The account scope for the webhook (OnlyFans and Fansly webhooks alike). Use
+        # "global" for all accounts, "inclusive" for only selected accounts, or
+        # "exclusive" for all except selected accounts.
         account_scope:,
         # The URL of your webhook endpoint.
         endpoint_url:,
         # An array of webhook events to subscribe to. For all options, refer to our **List
-        # Available Events** endpoint.
+        # Available Events** endpoint. A webhook is single-platform: subscribe to either
+        # OnlyFans events or Fansly (`fansly.*`) events, never both in one webhook.
         events:,
-        # An array of account IDs to apply the scope to. Required unless account_scope is
-        # "global".
+        # An array of account IDs to apply the scope to. Use OnlyFans account IDs
+        # (`acct_...`) for OnlyFans webhooks and Fansly account IDs (`fansly_acct_...`)
+        # for Fansly webhooks. Required unless account_scope is "global".
         account_ids: nil,
         # Optionally, enabled/disable the webhook. This will stop/resume the sending of
         # events, without having to delete the webhook.

data/rbi/onlyfans/models.rbi

@@ -132,8 +132,6 @@ module Onlyfans
 
   MeRetrieveParams = Onlyfans::Models::MeRetrieveParams
 
-  MessageAttachTagsParams = Onlyfans::Models::MessageAttachTagsParams
-
   NotificationGetCountsParams = Onlyfans::Models::NotificationGetCountsParams
 
   NotificationListParams = Onlyfans::Models::NotificationListParams

data/rbi/onlyfans/resources/analytics/financial/profitability.rbi

@@ -14,9 +14,7 @@ module Onlyfans
               months: Integer,
               request_options: Onlyfans::RequestOptions::OrHash
             ).returns(
-              T::Array[
-                Onlyfans::Models::Analytics::Financial::ProfitabilityGetHistoryResponseItem
-              ]
+              Onlyfans::Models::Analytics::Financial::ProfitabilityGetHistoryResponse
             )
           end
           def get_history(
@@ -40,9 +38,7 @@ module Onlyfans
               year: Integer,
               request_options: Onlyfans::RequestOptions::OrHash
             ).returns(
-              T::Array[
-                Onlyfans::Models::Analytics::Financial::ProfitabilityGetProfitabilityResponseItem
-              ]
+              Onlyfans::Models::Analytics::Financial::ProfitabilityGetProfitabilityResponse
             )
           end
           def get_profitability(

data/rbi/onlyfans/resources/chats/messages.rbi

@@ -25,7 +25,10 @@ module Onlyfans
         )
         end
 
-        # Get messages from a specific chat.
+        # Get messages from a specific chat. Use `filter=pinned` or
+        # [List Pinned Chat Messages](https://docs.onlyfansapi.com/api-reference/chat-messages/list-pinned-chat-messages)
+        # to retrieve only pinned messages. Follow `_pagination.next_page` until it is
+        # null; a short page can still have more results.
         sig do
           params(
             chat_id: String,
@@ -46,9 +49,9 @@ module Onlyfans
           account:,
           # Query param: Filter by certain messages. Currently, only pins are filterable.
           filter: nil,
-          # Query param: Use for pagination when `order=desc` (newest to oldest). Include
-          # this message ID as the first message in the results. Used to retrieve messages
-          # from e.g. the Search Chat Messages endpoint IDs.
+          # Query param: Use for pagination when `order=desc` (newest to oldest). Pass the
+          # last message ID from the previous page to retrieve older messages, excluding
+          # that cursor message.
           first_id: nil,
           # Query param: Use for pagination when `order=asc` (oldest to newest). Include
           # this message ID as the first message in the results. WARNING! The response list
@@ -59,7 +62,7 @@ module Onlyfans
           limit: nil,
           # Query param: Sort order for messages (desc or asc)
           order: nil,
-          # Query param: Whether to skip user details (all or none)
+          # Query param: Whether to skip user details (`all` or `none`).
           skip_users: nil,
           request_options: {}
         )
@@ -106,7 +109,10 @@ module Onlyfans
         )
         end
 
-        # Pin a message from a chat.
+        # Pin a message from a chat. Requires API-key write permission. No request body is
+        # needed. Use
+        # [List Pinned Chat Messages](https://docs.onlyfansapi.com/api-reference/chat-messages/list-pinned-chat-messages)
+        # to read the current pins.
         sig do
           params(
             message_id: String,
@@ -148,20 +154,47 @@ module Onlyfans
         end
 
         # Send a new message to a chat.
+        #
+        # **Idempotency.** Pass an `Idempotency-Key` header to make retries safe. The
+        # first request with a given key is executed normally and its response is stored
+        # for **24 hours**; any later request with the same key returns that stored
+        # response, plus an `Idempotent-Replayed: true` header, without contacting
+        # OnlyFans and without consuming credits. The replayed body is the original
+        # response with its `_meta._credits` block rewritten to show `used: 0` and your
+        # current balance.
+        #
+        # Keys are scoped to your team, this endpoint and the account in the URL, so the
+        # same value can be reused safely against a different account. Use a fresh, unique
+        # value (a UUID works well) for each message you send; it must be 1-255 printable
+        # ASCII characters.
+        #
+        # - `400 IDEMPOTENCY_KEY_INVALID` — the header value is empty, too long, or
+        #   contains non-ASCII characters.
+        # - `409 IDEMPOTENCY_CONFLICT` — an earlier request with this key is still
+        #   running. Retry once it finishes.
+        # - `422 IDEMPOTENCY_KEY_MISMATCH` — this key was already used with a different
+        #   request body or chat.
+        #
+        # Responses with a `5xx` status (and `408`/`429`) are never stored, so a failed
+        # send can be retried with the same key. The header is optional: omit it and the
+        # endpoint behaves exactly as before.
         sig do
           params(
             chat_id: String,
             account: String,
+            block_banned_words:
+              Onlyfans::Chats::MessageSendParams::BlockBannedWords::OrSymbol,
             giphy_id: String,
             locked_text: T::Boolean,
             media_files: T::Array[T.anything],
             previews: T::Array[T.anything],
-            price: Integer,
+            price: Float,
             reply_to_message_id: Integer,
             rf_guest: String,
             rf_partner: String,
             rf_tag: String,
             text: String,
+            idempotency_key: String,
             request_options: Onlyfans::RequestOptions::OrHash
           ).returns(Onlyfans::Models::Chats::MessageSendResponse)
         end
@@ -170,6 +203,11 @@ module Onlyfans
           chat_id,
           # Path param: The Account ID
           account:,
+          # Body param: Screen `text` for OnlyFans banned words and block the send if any
+          # are found (returns a 422 listing the offending words). `strict_ban` blocks all
+          # tiers, `risky` blocks Risky + Replace/soften, `replace_soften` blocks
+          # Replace/soften only. Omit to disable screening.
+          block_banned_words: nil,
           # Body param: The ID of the Giphy GIF to attach to the message. Get IDs from the
           # Giphy listing endpoints (`/giphy/trending`, `/giphy/search`).
           giphy_id: nil,
@@ -182,8 +220,8 @@ module Onlyfans
           # integer indices referencing uploaded files in `mediaFiles`. Will be shown if
           # `price` is provided.
           previews: nil,
-          # Body param: Price for paid content (0 or between 3-200). In case this is not
-          # zero, **mediaFiles** is required
+          # Body param: Price for paid content in USD (0 or between 3-200). In case this is
+          # not zero, **mediaFiles** is required
           price: nil,
           # Body param: Mark this message as a reply to another (can be either your own, or
           # the recipient's)
@@ -196,6 +234,8 @@ module Onlyfans
           rf_tag: nil,
           # Body param: The message text content. Required unless a media file is present.
           text: nil,
+          # Header param
+          idempotency_key: nil,
           request_options: {}
         )
         end
@@ -220,7 +260,10 @@ module Onlyfans
         )
         end
 
-        # Unpin a message from a chat.
+        # Unpin a message from a chat. Requires API-key delete permission; a read_write
+        # key cannot unpin. No request body is needed. Use
+        # [List Pinned Chat Messages](https://docs.onlyfansapi.com/api-reference/chat-messages/list-pinned-chat-messages)
+        # to read the current pins.
         sig do
           params(
             message_id: String,

data/rbi/onlyfans/resources/chats.rbi

@@ -35,7 +35,8 @@ module Onlyfans
         order: nil,
         # Search query to filter chats
         query: nil,
-        # Whether to skip user details in response (all or none). Default = all
+        # Whether to skip user details in the response (`all` or `none`). Defaults to
+        # `all`.
         skip_users: nil,
         request_options: {}
       )
@@ -98,8 +99,8 @@ module Onlyfans
         limit: nil,
         # Query param: Number of medias to skip for pagination
         offset: nil,
-        # Query param: Whether to skip user details in response (all or none). Default =
-        # all
+        # Query param: Whether to skip user details in the response (`all` or `none`).
+        # Defaults to `all`.
         skip_users: nil,
         # Query param: Filter by specific media types. Keep empty to return all.
         type: nil,
@@ -160,8 +161,8 @@ module Onlyfans
       end
 
       # Calling this endpoint will show the target fan a "Model is typing..." note in
-      # the chat for ~4 seconds. If you want to continue showing the indicator call this
-      # endpoint multiple times. Free - no credits charged.
+      # the chat for ~4 seconds. Duplicate calls for the same account and chat are
+      # coalesced during that window.
       sig do
         params(
           chat_id: String,

data/rbi/onlyfans/resources/data_exports.rbi

@@ -23,15 +23,20 @@ module Onlyfans
         # The end date for the export (ISO 8601 format).
         end_date:,
         # The output file format. Supported formats vary by export type: `csv` or `xlsx`
-        # for transactions, chat_messages, trial_links, tracking_links, smart_links,
-        # payouts, chargebacks, public_profiles, fans, followings; `zip` for media_vault.
+        # for transactions, chat_messages, fansly_chat_messages, trial_links,
+        # tracking_links, smart_links, payouts, chargebacks, public_profiles, fans,
+        # followings, profile_visitors; `zip` for media_vault.
         file_type:,
         # The start date for the export (ISO 8601 format).
         start_date:,
-        # The type of data to export
+        # The type of data to export. Use `fansly_chat_messages` to export Fansly chat
+        # messages (all other types are OnlyFans). `profile_visitors` returns one row per
+        # account per day, scraped one day at a time so the daily numbers are not
+        # aggregated away by OnlyFans.
         type:,
         # Array of account prefixed IDs to export data from. Not required for
-        # `public_profiles` type.
+        # `public_profiles` type. For `fansly_chat_messages`, pass Fansly account prefixed
+        # IDs (`fansly_acct_...`); all other types take OnlyFans account IDs.
         account_ids: nil,
         # When true, automatically starts the export after creation.
         auto_start: nil,
@@ -42,19 +47,23 @@ module Onlyfans
         # account, max 10,000,000), `maxChats` (optional per-account chat scrape limit),
         # `skipMassMessages` (optional, bool), `chatIds` (optional array of numeric
         # fan/chat IDs; filters output and can drastically reduce totals). For
-        # `media_vault`: `mediaType` (required, one of: `all`, `photo`, `gif`, `video`,
-        # `audio`). For `fans`: `type` (required, one of: `all`, `active`, `expired`,
-        # `latest`). For `followings`: `type` (required, one of: `all`, `active`,
-        # `expired`). For `public_profiles`: `query` (optional, full-text search),
-        # `gender` (optional, filter: male, female, trans, couple), `minSubscribePrice`
-        # (optional, USD), `maxSubscribePrice` (optional, USD), `location` (optional),
-        # `minPostsCount` (optional, minimum posts), `minPhotosCount` (optional, minimum
-        # photos), `minVideosCount` (optional, minimum videos), `minSubscribersCount`
-        # (optional, minimum subscribers), `minJoinDate` (optional, ISO 8601 date),
-        # `minLastSeenAt` (optional, ISO 8601 date), `createdAtFrom` (optional, ISO 8601
-        # date, profile added to DB after), `createdAtTo` (optional, ISO 8601 date,
-        # profile added to DB before), `instagram` (optional), `twitter` (optional),
-        # `tiktok` (optional), `maxResults` (optional, limit results).
+        # `fansly_chat_messages`: `maxMessages` (required per account, max 10,000,000),
+        # `maxChats` (optional per-account chat scrape limit), `chatIds` (optional array
+        # of Fansly group ID strings; filters output and can drastically reduce totals).
+        # For `media_vault`: `mediaType` (required, one of: `all`, `photo`, `gif`,
+        # `video`, `audio`). For `fans`: `type` (required, one of: `all`, `active`,
+        # `expired`, `latest`). For `followings`: `type` (required, one of: `all`,
+        # `active`, `expired`). For `public_profiles`: `query` (optional, full-text
+        # search), `gender` (optional, filter: male, female, trans, couple),
+        # `minSubscribePrice` (optional, USD), `maxSubscribePrice` (optional, USD),
+        # `location` (optional), `minPostsCount` (optional, minimum posts),
+        # `minPhotosCount` (optional, minimum photos), `minVideosCount` (optional, minimum
+        # videos), `minSubscribersCount` (optional, minimum subscribers),
+        # `maxSubscribersCount` (optional, maximum subscribers), `minJoinDate` (optional,
+        # ISO 8601 date), `minLastSeenAt` (optional, ISO 8601 date), `createdAtFrom`
+        # (optional, ISO 8601 date, profile added to DB after), `createdAtTo` (optional,
+        # ISO 8601 date, profile added to DB before), `instagram` (optional), `twitter`
+        # (optional), `tiktok` (optional), `maxResults` (optional, limit results).
         options: nil,
         request_options: {}
       )

data/rbi/onlyfans/resources/engagement/messages/direct_messages.rbi

@@ -22,8 +22,8 @@ module Onlyfans
           def list(
             # The Account ID
             account,
-            # The latest message to retrieve. Keep empty to get all. MUST BE DATE AFTER
-            # `startDate`. This is also used for pagination.
+            # The latest message to retrieve. Keep empty to get all. It must be after
+            # `startDate` and is also used for pagination.
             end_date: nil,
             # Number of messages to return (default = 10)
             limit: nil,
@@ -53,7 +53,7 @@ module Onlyfans
           def chart(
             # The Account ID
             account,
-            # End of the chart window in `Y-m-d H:i:s` format. Must be after `startDate`.
+            # End of the chart window in `Y-m-d H:i:s` format. It must be after `startDate`.
             end_date: nil,
             # Start of the chart window in `Y-m-d H:i:s` format.
             start_date: nil,

data/rbi/onlyfans/resources/engagement/messages/mass_messages.rbi

@@ -21,8 +21,8 @@ module Onlyfans
           def list(
             # The Account ID
             account,
-            # The latest message to retrieve. Keep empty to get all. MUST BE DATE AFTER
-            # `startDate`. This is also used for pagination.
+            # The latest message to retrieve. Keep empty to get all. It must be after
+            # `startDate` and is also used for pagination.
             end_date: nil,
             # Number of messages to return (default = 10)
             limit: nil,
@@ -50,7 +50,7 @@ module Onlyfans
           def chart(
             # The Account ID
             account,
-            # End of the chart window in `Y-m-d H:i:s` format. Must be after `startDate`.
+            # End of the chart window in `Y-m-d H:i:s` format. It must be after `startDate`.
             end_date: nil,
             # Start of the chart window in `Y-m-d H:i:s` format.
             start_date: nil,

data/rbi/onlyfans/resources/engagement/messages.rbi

@@ -38,7 +38,7 @@ module Onlyfans
           marker: nil,
           # Query param: Offset for pagination (default = 0)
           offset: nil,
-          # Query param: Optional flag for subsequent pages (example: all)
+          # Query param: Optional flag for subsequent pages (example: all).
           skip_users: nil,
           # Query param: Skip duplicate users in results (0/1). Default = 1
           skip_users_dups: nil,
@@ -58,8 +58,8 @@ module Onlyfans
         def get_top_message(
           # The Account ID
           account,
-          # The end date for the period. Keep empty to retrieve until now. MUST BE DATE
-          # AFTER `startDate`.
+          # The end date for the period. Keep empty to retrieve until now. It must be after
+          # `startDate`.
           end_date: nil,
           # The start date for the period. Keep empty to retrieve from the model start date.
           start_date: nil,

data/rbi/onlyfans/resources/fans.rbi

@@ -30,7 +30,19 @@ module Onlyfans
       )
       end
 
-      # Get a paginated list of fans for an Account. Newest fans are first.
+      # Get a paginated list of fans for an Account. Newest fans are first. Paginate by
+      # following `_pagination.next_page` until it is null (`data.hasMore` is the
+      # authoritative flag). Do NOT use the page's item count to detect the last page —
+      # OnlyFans occasionally returns fewer than `limit` items (e.g. 19 for limit=20) on
+      # a non-final page because it filters entries server-side; no fans are skipped. To
+      # track progress, GET `/{account}/me` returns data.subscribersCount (the current
+      # active-subscriber count) as a total.
+      #
+      # Supports `filter[max_total_spent]` (e.g. `filter[max_total_spent]=0` for fans
+      # who have never spent), which OnlyFans itself cannot do. Those requests are
+      # answered from OnlyFansAPI's own fan index rather than proxied, so the page is
+      # limited to fans we have already indexed for this account — see `data._source` in
+      # the response.
       sig do
         params(
           account: String,
@@ -46,8 +58,8 @@ module Onlyfans
         # The Account ID
         account,
         filter: nil,
-        # Number of fans to return (1-50). Must be at least 1. Must not be greater
-        # than 20.
+        # Number of fans to return (1-20). OnlyFans does not allow more than 20 per page.
+        # Must be at least 1. Must not be greater than 20.
         limit: nil,
         # Number of fans to skip. Must be at least 0.
         offset: nil,
@@ -59,7 +71,17 @@ module Onlyfans
       )
       end
 
-      # Get a paginated list of fans for an Account. Newest fans are first.
+      # Get a paginated list of fans for an Account. Newest fans are first. Paginate by
+      # following `_pagination.next_page` until it is null (`data.hasMore` is the
+      # authoritative flag). Do NOT use the page's item count to detect the last page —
+      # OnlyFans occasionally returns fewer than `limit` items (e.g. 19 for limit=20) on
+      # a non-final page because it filters entries server-side; no fans are skipped.
+      #
+      # Supports `filter[max_total_spent]` (e.g. `filter[max_total_spent]=0` for fans
+      # who have never spent), which OnlyFans itself cannot do. Those requests are
+      # answered from OnlyFansAPI's own fan index rather than proxied, so the page is
+      # limited to fans we have already indexed for this account — see `data._source` in
+      # the response.
       sig do
         params(
           account: String,
@@ -75,8 +97,8 @@ module Onlyfans
         # The Account ID
         account,
         filter: nil,
-        # Number of fans to return (1-50). Must be at least 1. Must not be greater
-        # than 20.
+        # Number of fans to return (1-20). OnlyFans does not allow more than 20 per page.
+        # Must be at least 1. Must not be greater than 20.
         limit: nil,
         # Number of fans to skip. Must be at least 0.
         offset: nil,
@@ -89,6 +111,17 @@ module Onlyfans
       end
 
       # Get a paginated list of expired fans for an Account. Newest fans are first.
+      # Paginate by following `_pagination.next_page` until it is null (`data.hasMore`
+      # is the authoritative flag). Do NOT use the page's item count to detect the last
+      # page — OnlyFans occasionally returns fewer than `limit` items (e.g. 19 for
+      # limit=20) on a non-final page because it filters entries server-side; no fans
+      # are skipped.
+      #
+      # Supports `filter[max_total_spent]` (e.g. `filter[max_total_spent]=0` for fans
+      # who have never spent), which OnlyFans itself cannot do. Those requests are
+      # answered from OnlyFansAPI's own fan index rather than proxied, so the page is
+      # limited to fans we have already indexed for this account — see `data._source` in
+      # the response.
       sig do
         params(
           account: String,
@@ -104,8 +137,8 @@ module Onlyfans
         # The Account ID
         account,
         filter: nil,
-        # Number of fans to return (1-50). Must be at least 1. Must not be greater
-        # than 20.
+        # Number of fans to return (1-20). OnlyFans does not allow more than 20 per page.
+        # Must be at least 1. Must not be greater than 20.
         limit: nil,
         # Number of fans to skip. Must be at least 0.
         offset: nil,
@@ -133,16 +166,16 @@ module Onlyfans
       def list_latest(
         # The Account ID
         account,
-        # End date for filtering (required with start_date). This field is required when
-        # <code>start_date</code> is present.
+        # End date for filtering (required with start_date). Must be a valid date. Must
+        # not be greater than 255 characters.
         end_date: nil,
         # Number of fans to return (1-50). Must be at least 1. Must not be greater
-        # than 100.
+        # than 50.
         limit: nil,
         # Number of fans to skip. Must be at least 0.
         offset: nil,
-        # Start date for filtering (required with end_date). This field is required when
-        # <code>end_date</code> is present.
+        # Start date for filtering (required with end_date). Must be a valid date. Must
+        # not be greater than 255 characters.
         start_date: nil,
         # Filter by type: total, renew, or new.
         type: nil,
@@ -166,11 +199,11 @@ module Onlyfans
         account,
         # Sort by: total (default), subscribes, tips, messages, post, streams.
         by: nil,
-        # End date for filtering (required with start_date). This field is required when
-        # <code>start_date</code> is present.
+        # End date for filtering (required with start_date). Must be a valid date. Must
+        # not be greater than 255 characters.
         end_date: nil,
-        # Start date for filtering (required with end_date). This field is required when
-        # <code>end_date</code> is present.
+        # Start date for filtering (required with end_date). Must be a valid date. Must
+        # not be greater than 255 characters.
         start_date: nil,
         request_options: {}
       )