OnlyFans API
FanvueFans

Check Online Status

Check whether a set of fans is online in one call, so a chat list can be decorated without a request per fan. Proxies Fanvue's POST /v1/chats/statuses, which accepts up to 100 UUIDs and reports fans who hide their online visibility as offline with no last seen timestamp. Fanvue rate limits this endpoint at 80 requests per 60 seconds rather than the usual 200.

POST
/api/fanvue/{fanvueAccount}/fans/online-status
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

fanvueAccount*string

The Fanvue Account ID

Request Body

application/json

userUuids*array<string>

The fan user UUIDs to check (1 - 100).

Response Body

application/json

curl -X POST "https://app.onlyfansapi.com/api/fanvue/fanvue_acct_XXXXXXXXXXXXXXX/fans/online-status" \  -H "Content-Type: application/json" \  -d '{    "userUuids": [      "f47ac10b-58cc-4372-a567-0e02b2c3d479"    ]  }'
{
  "data": {
    "f47ac10b-58cc-4372-a567-0e02b2c3d479": {
      "isOnline": false,
      "lastSeenAt": "2026-09-22T10:38:48.809Z"
    },
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8": {
      "isOnline": false,
      "lastSeenAt": null
    }
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 10055811,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 5000,
      "limit_day": null,
      "remaining_minute": 4999,
      "remaining_day": null,
      "notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
    }
  }
}