> ## 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.

# Get AI Voice Message Stats (/api-reference/ai-voice-messages/get-ai-voice-message-stats)

Compare sent AI voice messages and reply rates across your permitted OnlyFans creator accounts. Deleted accounts are excluded; disconnected accounts and accounts with no sends are included. Dates filter when messages were sent, not when replies arrived. Omit dates for all time. A subsequent incoming fan message credits every preceding unreplied sent voice message in the chat, with no attribution time limit; this does not prove the voice message caused the reply. Rates are percentages, or null when no messages were sent. Totals cover only the accounts returned.

## OpenAPI

````yaml https://app.onlyfansapi.com/scribe-docs/openapi.yaml get /api/ai-voice-messages/stats
openapi: 3.0.3
info:
  title: OnlyFans API
  description: ""
  version: 1.0.0
servers:
  - url: https://app.onlyfansapi.com
security:
  - default: []
tags:
  - name: AI Voice Messages
    description: ""
  - name: API Keys
    description: ""
  - name: Account
    description: Endpoints for your linked accounts
  - name: Analytics - Financial
    description: APIs for retrieving financial analytics data
  - name: Analytics - Summary
    description: APIs for retrieving summary analytics data
  - name: Banking
    description: Operations related to user banking details, payout methods, legal
      and tax information, and account country settings.
  - name: Banned Words
    description: Reference list of OnlyFans banned words used by the
      `blockBannedWords` screening parameter
  - name: Blocked / Restricted Users
    description: APIs for listing the users an account has blocked or restricted
  - name: Chargebacks
    description: ""
  - name: Chat Messages
    description: ""
  - name: Chats
    description: ""
  - name: Client Sessions
    description: ""
  - name: Connect OnlyFans Account
    description: ""
  - name: Data Exports
    description: APIs for managing data exports
  - name: Engagement / Messages
    description: ""
  - name: Fans
    description: APIs for managing OnlyFans fans (subscribers)
  - name: Fans - AI Summary
    description: APIs for generating and retrieving AI-powered fan profile summaries
  - name: Following
    description: APIs for managing OnlyFans followings (people you're subscribed to)
  - name: Free Trial Links
    description: APIs for managing Free Trial Links. Revenue totals are net earnings
      after refunds and chargebacks. `revenue.chargebacks` (or
      `summary.chargebacks_total` in stats) is the positive cached net amount
      already excluded from revenue; do not subtract it again. Spender responses
      include chargebacks across all attributed periods for each fan with
      positive net revenue.
  - name: Giphy
    description: ""
  - name: Link Tags
    description: APIs for managing tags on free trial links, tracking links, and Smart Links
  - name: Mass Messaging
    description: ""
  - name: Media
    description: ""
  - name: Media Vault
    description: ""
  - name: Media Vault Lists
    description: ""
  - name: Notifications
    description: Endpoints for managingr account notifications
  - name: Payouts
    description: ""
  - name: Post Comments
    description: ""
  - name: Post Labels
    description: APIs for managing your post labels
  - name: Posts
    description: APIs for managing OnlyFans posts
  - name: Profile Content
    description: Read another user's profile content using your connected OnlyFans
      account. OnlyFans enforces subscription and purchase requirements; these
      endpoints do not unlock content. Response samples use captured OnlyFans
      payloads with anonymized IDs, text, and media URLs; OFAPI metadata values
      are illustrative.
  - name: Promotions
    description: ""
  - name: Public Profiles
    description: ""
  - name: Queue
    description: ""
  - name: Release Forms
    description: APIs for managing OnlyFans release forms
  - name: Saved For Later (Messages)
    description: ""
  - name: Saved For Later (Posts)
    description: ""
  - name: Settings
    description: ""
  - name: Shared Free Trial Links
    description: APIs for Free Trial Links that other OF creators have shared with
      this account. Revenue, cost, and spender data are not available for shared
      links.
  - name: Shared Tracking Links
    description: APIs for Tracking Links (campaigns) that other OF creators have
      shared with this account. Revenue, cost, and spender data are not
      available for shared campaigns.
  - name: Smart Link Postbacks
    description: APIs for managing Smart Link postback destinations
  - name: Smart Links
    description: APIs for managing Smart Links (Free Trial Links and Tracking Links
      with pooled inventory)
  - name: Statistics
    description: ""
  - name: Stored Free Trial Links
    description: Instant APIs for retrieving stored free trial links from the
      OnlyFansAPI Cache (free, no credits used). `revenue.total` is net earnings
      after refunds and chargebacks. `revenue.chargebacks` is the positive
      cached net amount already excluded from that total; do not subtract it
      again.
  - name: Stored Shared Free Trial Links
    description: Instant APIs for retrieving stored shared Free Trial Links from the
      OnlyFansAPI Cache (free, no credits used)
  - name: Stored Shared Tracking Links
    description: Instant APIs for retrieving stored shared Tracking Links
      (campaigns) from the OnlyFansAPI Cache (free, no credits used)
  - name: Stored Tracking Links
    description: Instant APIs for retrieving stored tracking links from the
      OnlyFansAPI Cache (free, no credits used). `revenue.total` is net earnings
      after refunds and chargebacks. `revenue.chargebacks` is the positive
      cached net amount already excluded from that total; do not subtract it
      again.
  - name: Stories
    description: APIs for managing OnlyFans stories
  - name: Story Highlights
    description: APIs for managing OnlyFans story highlights
  - name: Subscription Bundles
    description: ""
  - name: Tracking Links
    description: APIs for managing tracking links. Revenue totals are net earnings
      after refunds and chargebacks. `revenue.chargebacks` (or
      `summary.chargebacks_total` in stats) is the positive cached net amount
      already excluded from revenue; do not subtract it again. Spender responses
      include chargebacks across all attributed periods for each fan with
      positive net revenue.
  - name: Transactions
    description: APIs for managing OnlyFans transactions
  - name: Usage
    description: Credit usage reporting for your team
  - name: User List Collections
    description: ""
  - name: Users
    description: APIs for fetching OnlyFans users
  - name: Webhooks
    description: ""
paths:
  /api/ai-voice-messages/stats:
    get:
      summary: Get AI Voice Message Stats
      operationId: getAIVoiceMessageStats
      description: Compare sent AI voice messages and reply rates across your
        permitted OnlyFans creator accounts. Deleted accounts are excluded;
        disconnected accounts and accounts with no sends are included. Dates
        filter when messages were sent, not when replies arrived. Omit dates for
        all time. A subsequent incoming fan message credits every preceding
        unreplied sent voice message in the chat, with no attribution time
        limit; this does not prove the voice message caused the reply. Rates are
        percentages, or null when no messages were sent. Totals cover only the
        accounts returned.
      parameters:
        - in: query
          name: account_id
          description: Optionally limit the report to one permitted account.
          example: acct_abc123
          required: false
          schema:
            type: string
            description: Optionally limit the report to one permitted account.
            example: acct_abc123
        - in: query
          name: start_date
          description: Inclusive UTC send date, in YYYY-MM-DD format.
          example: 2026-09-01
          required: false
          schema:
            type: string
            description: Inclusive UTC send date, in YYYY-MM-DD format.
            example: 2026-09-01
        - in: query
          name: end_date
          description: Inclusive UTC send date, in YYYY-MM-DD format.
          example: 2026-09-30
          required: false
          schema:
            type: string
            description: Inclusive UTC send date, in YYYY-MM-DD format.
            example: 2026-09-30
      responses:
        "200":
          description: ""
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    - account_id: acct_abc123
                      name: Creator
                      username: creator
                      sent: 200
                      replied: 85
                      reply_rate: 42.5
                  totals:
                    sent: 200
                    replied: 85
                    reply_rate: 42.5
                  meta:
                    start_date: 2026-09-01
                    end_date: 2026-09-30
                    timezone: UTC
                    snapshot_at: 2026-10-01T00:00:00+00:00
                    reply_rate_definition: Sent voice messages followed by an incoming fan message /
                      sent voice messages × 100. No reply attribution time
                      limit; one fan message can credit multiple voice messages.
                properties:
                  data:
                    type: array
                    example:
                      - account_id: acct_abc123
                        name: Creator
                        username: creator
                        sent: 200
                        replied: 85
                        reply_rate: 42.5
                    items:
                      type: object
                      properties:
                        account_id:
                          type: string
                          example: acct_abc123
                        name:
                          type: string
                          example: Creator
                        username:
                          type: string
                          example: creator
                          nullable: true
                        sent:
                          type: integer
                          example: 200
                        replied:
                          type: integer
                          example: 85
                        reply_rate:
                          type: number
                          example: 42.5
                          description: Percentage of sent voice messages followed by a fan reply; null
                            when sent is zero.
                          nullable: true
                      required:
                        - username
                        - reply_rate
                  totals:
                    type: object
                    properties:
                      sent:
                        type: integer
                        example: 200
                      replied:
                        type: integer
                        example: 85
                      reply_rate:
                        type: number
                        example: 42.5
                        description: Total replied / total sent × 100; null when sent is zero.
                        nullable: true
                    required:
                      - reply_rate
                  meta:
                    type: object
                    properties:
                      start_date:
                        type: string
                        example: 2026-09-01
                        nullable: true
                      end_date:
                        type: string
                        example: 2026-09-30
                        nullable: true
                      timezone:
                        type: string
                        example: UTC
                      snapshot_at:
                        type: string
                        example: 2026-10-01T00:00:00+00:00
                      reply_rate_definition:
                        type: string
                        example: Sent voice messages followed by an incoming fan message / sent voice
                          messages × 100. No reply attribution time limit; one
                          fan message can credit multiple voice messages.
                    required:
                      - start_date
                      - end_date
      tags:
        - AI Voice Messages
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: Get your API Key from OnlyFansAPI Console -
        https://app.onlyfansapi.com/api-keys
````