> ## 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. # Mass Messages Chart (/api-reference/engagement-messages/mass-messages-chart) Get engagement chart metrics for mass messages: sent count and purchase amount over time. ## OpenAPI ````yaml https://app.onlyfansapi.com/scribe-docs/openapi.yaml get /api/{account}/engagement/messages/mass-messages/chart openapi: 3.0.3 info: title: OnlyFans API description: "" version: 1.0.0 servers: - url: https://app.onlyfansapi.com security: - default: [] tags: - 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: 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 - name: Giphy description: "" - name: Link Tags description: APIs for managing tags on free trial links and tracking 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: 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) - 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) - 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 - name: Transactions description: APIs for managing OnlyFans transactions - name: User List Collections description: "" - name: Users description: APIs for fetching OnlyFans users - name: Webhooks description: "" paths: /api/{account}/engagement/messages/mass-messages/chart: parameters: - in: path name: account description: The Account ID example: acct_XXXXXXXXXXXXXXX required: true schema: type: string get: summary: Mass Messages Chart operationId: massMessagesChart description: "Get engagement chart metrics for mass messages: sent count and purchase amount over time." parameters: - in: query name: startDate description: Start of the chart window in `Y-m-d H:i:s` format. example: 2026-01-07 00:00:00 required: false schema: type: string description: Start of the chart window in `Y-m-d H:i:s` format. example: 2026-01-07 00:00:00 - in: query name: endDate description: End of the chart window in `Y-m-d H:i:s` format. Must be after `startDate`. example: 2026-02-06 22:19:59 required: false schema: type: string description: End of the chart window in `Y-m-d H:i:s` format. Must be after `startDate`. example: 2026-02-06 22:19:59 - in: query name: withTotal description: Include `total` and `delta` aggregates in the response. Defaults to `true`. example: true required: false schema: type: boolean description: Include `total` and `delta` aggregates in the response. Defaults to `true`. example: true responses: "200": description: "" content: application/json: schema: type: object example: data: group_messages: chart: - date: 2026-01-07T00:00:00+00:00 count: 8 - date: 2026-01-08T00:00:00+00:00 count: 5 - date: 2026-01-09T00:00:00+00:00 count: 10 - date: 2026-01-10T00:00:00+00:00 count: 7 - date: 2026-01-11T00:00:00+00:00 count: 9 - date: 2026-01-12T00:00:00+00:00 count: 11 - date: 2026-01-13T00:00:00+00:00 count: 6 - date: 2026-01-14T00:00:00+00:00 count: 9 - date: 2026-01-15T00:00:00+00:00 count: 9 - date: 2026-01-16T00:00:00+00:00 count: 12 - date: 2026-01-17T00:00:00+00:00 count: 8 - date: 2026-01-18T00:00:00+00:00 count: 9 - date: 2026-01-19T00:00:00+00:00 count: 8 - date: 2026-01-20T00:00:00+00:00 count: 5 - date: 2026-01-21T00:00:00+00:00 count: 8 - date: 2026-01-22T00:00:00+00:00 count: 11 - date: 2026-01-23T00:00:00+00:00 count: 9 - date: 2026-01-24T00:00:00+00:00 count: 8 - date: 2026-01-25T00:00:00+00:00 count: 8 - date: 2026-01-26T00:00:00+00:00 count: 10 - date: 2026-01-27T00:00:00+00:00 count: 5 - date: 2026-01-28T00:00:00+00:00 count: 7 - date: 2026-01-29T00:00:00+00:00 count: 6 - date: 2026-01-30T00:00:00+00:00 count: 9 - date: 2026-01-31T00:00:00+00:00 count: 4 - date: 2026-02-01T00:00:00+00:00 count: 6 - date: 2026-02-02T00:00:00+00:00 count: 12 - date: 2026-02-03T00:00:00+00:00 count: 6 - date: 2026-02-04T00:00:00+00:00 count: 10 - date: 2026-02-05T00:00:00+00:00 count: 13 - date: 2026-02-06T00:00:00+00:00 count: 8 total: 256 delta: 32.6 group_messages_purchases: chart: - date: 2026-01-07T00:00:00+00:00 count: 846.54 - date: 2026-01-08T00:00:00+00:00 count: 549.11 - date: 2026-01-09T00:00:00+00:00 count: 1665.94 - date: 2026-01-10T00:00:00+00:00 count: 1063.36 - date: 2026-01-11T00:00:00+00:00 count: 1368.39 - date: 2026-01-12T00:00:00+00:00 count: 1207.98 - date: 2026-01-13T00:00:00+00:00 count: 1067.6 - date: 2026-01-14T00:00:00+00:00 count: 1009.73 - date: 2026-01-15T00:00:00+00:00 count: 548.28 - date: 2026-01-16T00:00:00+00:00 count: 1225.95 - date: 2026-01-17T00:00:00+00:00 count: 729.63 - date: 2026-01-18T00:00:00+00:00 count: 1031.37 - date: 2026-01-19T00:00:00+00:00 count: 1030.77 - date: 2026-01-20T00:00:00+00:00 count: 664.54 - date: 2026-01-21T00:00:00+00:00 count: 989.29 - date: 2026-01-22T00:00:00+00:00 count: 1208.15 - date: 2026-01-23T00:00:00+00:00 count: 981.15 - date: 2026-01-24T00:00:00+00:00 count: 807.61 - date: 2026-01-25T00:00:00+00:00 count: 1343.55 - date: 2026-01-26T00:00:00+00:00 count: 1040.85 - date: 2026-01-27T00:00:00+00:00 count: 468.98 - date: 2026-01-28T00:00:00+00:00 count: 1515.54 - date: 2026-01-29T00:00:00+00:00 count: 1497.24 - date: 2026-01-30T00:00:00+00:00 count: 1331.33 - date: 2026-01-31T00:00:00+00:00 count: 938.93 - date: 2026-02-01T00:00:00+00:00 count: 372.78 - date: 2026-02-02T00:00:00+00:00 count: 780.88 - date: 2026-02-03T00:00:00+00:00 count: 521.2 - date: 2026-02-04T00:00:00+00:00 count: 1409.73 - date: 2026-02-05T00:00:00+00:00 count: 1330.83 - date: 2026-02-06T00:00:00+00:00 count: 1504.63 total: 32131 delta: -1.7 _meta: _credits: used: 1 balance: 11270561 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: group_messages: type: object properties: chart: type: array example: - date: 2026-01-07T00:00:00+00:00 count: 8 - date: 2026-01-08T00:00:00+00:00 count: 5 - date: 2026-01-09T00:00:00+00:00 count: 10 - date: 2026-01-10T00:00:00+00:00 count: 7 - date: 2026-01-11T00:00:00+00:00 count: 9 - date: 2026-01-12T00:00:00+00:00 count: 11 - date: 2026-01-13T00:00:00+00:00 count: 6 - date: 2026-01-14T00:00:00+00:00 count: 9 - date: 2026-01-15T00:00:00+00:00 count: 9 - date: 2026-01-16T00:00:00+00:00 count: 12 - date: 2026-01-17T00:00:00+00:00 count: 8 - date: 2026-01-18T00:00:00+00:00 count: 9 - date: 2026-01-19T00:00:00+00:00 count: 8 - date: 2026-01-20T00:00:00+00:00 count: 5 - date: 2026-01-21T00:00:00+00:00 count: 8 - date: 2026-01-22T00:00:00+00:00 count: 11 - date: 2026-01-23T00:00:00+00:00 count: 9 - date: 2026-01-24T00:00:00+00:00 count: 8 - date: 2026-01-25T00:00:00+00:00 count: 8 - date: 2026-01-26T00:00:00+00:00 count: 10 - date: 2026-01-27T00:00:00+00:00 count: 5 - date: 2026-01-28T00:00:00+00:00 count: 7 - date: 2026-01-29T00:00:00+00:00 count: 6 - date: 2026-01-30T00:00:00+00:00 count: 9 - date: 2026-01-31T00:00:00+00:00 count: 4 - date: 2026-02-01T00:00:00+00:00 count: 6 - date: 2026-02-02T00:00:00+00:00 count: 12 - date: 2026-02-03T00:00:00+00:00 count: 6 - date: 2026-02-04T00:00:00+00:00 count: 10 - date: 2026-02-05T00:00:00+00:00 count: 13 - date: 2026-02-06T00:00:00+00:00 count: 8 items: type: object properties: date: type: string example: 2026-01-07T00:00:00+00:00 count: type: integer example: 8 total: type: integer example: 256 delta: type: number example: 32.6 group_messages_purchases: type: object properties: chart: type: array example: - date: 2026-01-07T00:00:00+00:00 count: 846.54 - date: 2026-01-08T00:00:00+00:00 count: 549.11 - date: 2026-01-09T00:00:00+00:00 count: 1665.94 - date: 2026-01-10T00:00:00+00:00 count: 1063.36 - date: 2026-01-11T00:00:00+00:00 count: 1368.39 - date: 2026-01-12T00:00:00+00:00 count: 1207.98 - date: 2026-01-13T00:00:00+00:00 count: 1067.6 - date: 2026-01-14T00:00:00+00:00 count: 1009.73 - date: 2026-01-15T00:00:00+00:00 count: 548.28 - date: 2026-01-16T00:00:00+00:00 count: 1225.95 - date: 2026-01-17T00:00:00+00:00 count: 729.63 - date: 2026-01-18T00:00:00+00:00 count: 1031.37 - date: 2026-01-19T00:00:00+00:00 count: 1030.77 - date: 2026-01-20T00:00:00+00:00 count: 664.54 - date: 2026-01-21T00:00:00+00:00 count: 989.29 - date: 2026-01-22T00:00:00+00:00 count: 1208.15 - date: 2026-01-23T00:00:00+00:00 count: 981.15 - date: 2026-01-24T00:00:00+00:00 count: 807.61 - date: 2026-01-25T00:00:00+00:00 count: 1343.55 - date: 2026-01-26T00:00:00+00:00 count: 1040.85 - date: 2026-01-27T00:00:00+00:00 count: 468.98 - date: 2026-01-28T00:00:00+00:00 count: 1515.54 - date: 2026-01-29T00:00:00+00:00 count: 1497.24 - date: 2026-01-30T00:00:00+00:00 count: 1331.33 - date: 2026-01-31T00:00:00+00:00 count: 938.93 - date: 2026-02-01T00:00:00+00:00 count: 372.78 - date: 2026-02-02T00:00:00+00:00 count: 780.88 - date: 2026-02-03T00:00:00+00:00 count: 521.2 - date: 2026-02-04T00:00:00+00:00 count: 1409.73 - date: 2026-02-05T00:00:00+00:00 count: 1330.83 - date: 2026-02-06T00:00:00+00:00 count: 1504.63 items: type: object properties: date: type: string example: 2026-01-07T00:00:00+00:00 count: type: number example: 846.54 total: type: integer example: 32131 delta: type: number example: -1.7 _meta: type: object properties: _credits: type: object properties: used: type: integer example: 1 balance: type: integer example: 11270561 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: - Engagement / Messages components: securitySchemes: default: type: http scheme: bearer description: Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys ````