v8

latestOpenAPI 3.0.3raw.githubusercontent.com2026-05-2526602.8 MB

Transactions

List Transactions

Get a paginated list of transactions for an Account. Newest transactions are first. You can filter by transaction type and tips source.

get/api/{account}/transactions

Query parameters

limitstring

The number of transactions to return. Recommended: 10

startDatestring

The start date for transactions list. Default: -30days

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

The start date for transactions list. Default: -30days

markerstring

The marker used for pagination. Default: null

Example:1739155047

The marker used for pagination. Default: null

typestring

Filter by transaction type. Options: subscribes, tips, post, chat_messages, stream

Example:tips

Filter by transaction type. Options: subscribes, tips, post, chat_messages, stream

tipsSourcestring

Filter tips by source. Only applies when type=tips. Options: profile, post_all, chat, stream, story

Example:post_all

Filter tips by source. Only applies when type=tips. Options: profile, post_all, chat, stream, story

Response

Success

Example response

{
  "data": {
    "list": [
      {
        "amount": 19.99,
        "vatAmount": 0,
        "taxAmount": 0,
        "net": 15.99,
        "fee": 4,
        "createdAt": "2025-02-10T02:51:22+00:00",
        "currency": "USD",
        "description": "Payment for message from <a href=\"https://onlyfans.com/XXXXXXXX\">XXXXXXXX</a>",
        "status": "loading",
        "user": {
          "view": "t",
          "id": 123123123,
          "name": "Michael XXXXXXXX",
          "username": "u123123123",
          "isVerified": false,
          "avatar": "https://public.onlyfans.com/files/XXXXXXXXXX.jpg",
          "avatarThumbs": {
            "c50": "https://thumbs.onlyfans.com/public/files/thumbs/c50/XXXXXXXXXX.jpg",
            "c144": "https://thumbs.onlyfans.com/public/files/thumbs/c144/XXXXXXXXXX.jpg"
          }
        },
        "payoutPendingDays": 7,
        "id": "5XXXXXXXXXaa1aXXXXXXXXXXX",
        "type": "message"
      }
    ],
    "marker": 1739156703,
    "hasMore": true,
    "nextMarker": 1739155047
  },
  "_pagination": {
    "next_page": "https://app.onlyfansapi.com/api/acct_XXXXXXXX/transactions?startDate=-30days&marker=1739155047&"
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 34,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 990,
      "remaining_day": 49977
    }
  }
}