> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onlyfansapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Check Online Status (/api-reference/fanvue/fans/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.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-fanvue-docs/openapi.yaml post /api/fanvue/{fanvueAccount}/fans/online-status
openapi: 3.0.3
info:
  title: Fanvue API Documentation
  description: ""
  version: 1.0.0
servers:
  - url: https://app.onlyfansapi.com
security:
  - default: []
tags:
  - name: Account
    description: Endpoints for your connected Fanvue accounts
  - name: Chat Messages
    description: Endpoints for the messages inside a Fanvue chat.
  - name: Chats
    description: Endpoints for a Fanvue creator's inbox. A chat is identified by the
      fan's user UUID.
  - name: Fans
    description: "Endpoints for the fans of a Fanvue creator: subscribers,
      followers, smart lists and per-fan insights."
  - name: Fanvue Account
    description: Endpoints for the connected Fanvue creator itself.
  - name: Insights
    description: "Revenue and growth reporting for a Fanvue creator: per-transaction
      earnings, the aggregated earnings summary, the subscriber trend and top
      spenders."
  - name: Profiles
    description: Public Fanvue creator profiles, readable without connecting the creator.
paths:
  /api/fanvue/{fanvueAccount}/fans/online-status:
    parameters:
      - in: path
        name: fanvueAccount
        description: The Fanvue Account ID
        example: fanvue_acct_XXXXXXXXXXXXXXX
        required: true
        schema:
          type: string
    post:
      summary: Check Online Status
      operationId: checkOnlineStatus
      description: 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.
      parameters: []
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                type: object
                example:
                  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.
                properties:
                  data:
                    type: object
                    properties:
                      f47ac10b-58cc-4372-a567-0e02b2c3d479:
                        type: object
                        properties:
                          isOnline:
                            type: boolean
                            example: false
                          lastSeenAt:
                            type: string
                            example: 2026-09-22T10:38:48.809Z
                      6ba7b810-9dad-11d1-80b4-00c04fd430c8:
                        type: object
                        properties:
                          isOnline:
                            type: boolean
                            example: false
                          lastSeenAt:
                            type: string
                            example: null
                            nullable: true
                  _meta:
                    type: object
                    properties:
                      _credits:
                        type: object
                        properties:
                          used:
                            type: integer
                            example: 1
                          balance:
                            type: integer
                            example: 10055811
                          note:
                            type: string
                            example: Always
                      _cache:
                        type: object
                        properties:
                          is_cached:
                            type: boolean
                            example: false
                          note:
                            type: string
                            example: Cache disabled for this endpoint
                      _rate_limits:
                        type: object
                        properties:
                          limit_minute:
                            type: integer
                            example: 5000
                          limit_day:
                            type: string
                            example: null
                            nullable: true
                          remaining_minute:
                            type: integer
                            example: 4999
                          remaining_day:
                            type: string
                            example: null
                            nullable: true
                          notice:
                            type: string
                            example: We have decided to remove our daily rate limits. Please remove any
                              references to these in your integrations.
      tags:
        - Fans
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                userUuids:
                  type: array
                  description: The fan user UUIDs to check (1 - 100).
                  example:
                    - f47ac10b-58cc-4372-a567-0e02b2c3d479
                  items:
                    type: string
              required:
                - userUuids
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````