> ## 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. # List Chat Messages (/api-reference/fansly/chats/list-chat-messages) Get the messages for a specific chat. The response also includes aggregated content referenced from the messages — `accountMedia`, `accountMediaBundles`, `tips`, `tipGoals`, `accountMediaOrders`, `stories`, `storyOrders`. ## OpenAPI ````yaml https://app.onlyfansapi.com/scribe-fansly-docs/openapi.yaml get /api/fansly/{fanslyAccount}/chats/{chat_id}/messages openapi: 3.0.3 info: title: Fansly API Documentation description: "" version: 1.0.0 servers: - url: https://app.onlyfansapi.com security: - default: [] tags: - name: Account description: Endpoints for your linked Fansly accounts - name: Chats description: Endpoints for Fansly chats (messaging groups) - name: Earnings description: Endpoints for Fansly Earnings — wallets, balances, transactions, payouts, and statements. - name: Followers description: Endpoints for Fansly followers. - name: Lists description: Endpoints for Fansly subscriber/fan lists (e.g. "VIP", "Spenders"). - name: Profile Statistics description: Endpoints for Fansly Profile Statistics (viewer engagement insights). - name: Subscribers description: Endpoints for Fansly subscribers and subscription tiers. - name: Top Supporters description: Endpoints for the Fansly "Top Supporters" view — see who spends the most and what they spend on. - name: Tracking Links description: Endpoints for Fansly tracking links — per-source attribution links (e.g. "Twitter bio", "FYP", "Search"). - name: Users description: APIs for fetching Fansly users paths: /api/fansly/{fanslyAccount}/chats/{chat_id}/messages: parameters: - in: path name: fanslyAccount description: The Fansly Account ID example: fansly_acct_XXXXXXXXXXXXXXX required: true schema: type: string - in: path name: chat_id description: The Fansly chat (group) ID. example: "918197836133183488" required: true schema: type: string get: summary: List Chat Messages operationId: listChatMessages description: Get the messages for a specific chat. The response also includes aggregated content referenced from the messages — `accountMedia`, `accountMediaBundles`, `tips`, `tipGoals`, `accountMediaOrders`, `stories`, `storyOrders`. parameters: - in: query name: limit description: Number of messages to return (1 - 100). Default = 25 example: 25 required: false schema: type: string description: Number of messages to return (1 - 100). Default = 25 example: 25 - in: query name: before description: Cursor for older messages — the ID of a message you've already received. Pass the oldest message ID from the previous page to fetch the next page. Leave empty for the most recent messages. example: "918197866982297600" required: false schema: type: string description: Cursor for older messages — the ID of a message you've already received. Pass the oldest message ID from the previous page to fetch the next page. Leave empty for the most recent messages. example: "918197866982297600" responses: "200": description: Success content: application/json: schema: type: object example: data: messages: - id: "400000000000000003" type: 1 dataVersion: 1 content: Message text three groupId: "200000000000000001" senderId: "300000000000000001" correlationId: "400000000000000093" inReplyTo: null inReplyToRoot: null createdAt: 1700000200 attachments: [] embeds: [] interactions: - userId: "100000000000000001" readAt: 1700000200 deliveredAt: 1700000200 likes: [] totalTipAmount: 0 - id: "400000000000000002" type: 1 dataVersion: 1 content: Message text two groupId: "200000000000000001" senderId: "300000000000000001" correlationId: "400000000000000092" inReplyTo: null inReplyToRoot: null createdAt: 1700000100 attachments: - messageId: "400000000000000002" contentType: 1 contentId: "700000000000000001" pos: 0 embeds: [] interactions: [] likes: [] totalTipAmount: 0 - id: "400000000000000001" type: 1 dataVersion: 1 content: Message text one groupId: "200000000000000001" senderId: "300000000000000001" correlationId: "400000000000000091" inReplyTo: null inReplyToRoot: null createdAt: 1700000000 attachments: [] embeds: [] interactions: [] likes: [] totalTipAmount: 0 accountMedia: - id: "700000000000000001" accountId: "300000000000000001" mediaId: "800000000000000001" previewId: null permissionFlags: 0 price: 0 createdAt: 1700000000 deletedAt: null deleted: false permissions: permissionFlags: [] accountPermissionFlags: flags: 2 metadata: "{}" likeCount: 0 media: id: "800000000000000001" type: 1 status: 1 accountId: "300000000000000001" mimetype: image/jpeg flags: 0 location: /300000000000000001/800000000000000001.jpeg width: 1080 height: 1440 metadata: '{"resolutionMode":2}' updatedAt: 1700000000 createdAt: 1700000000 variants: [] variantHash: {} locations: - locationId: "1" location: https://cdn3.fansly.com/300000000000000001/800000000000000001.jpeg purchased: false whitelisted: false accountPermissionFlags: 2 access: true accountMediaBundles: [] tips: [] tipGoals: [] accountMediaOrders: [] stories: [] storyOrders: [] hasMore: false _pagination: next_page: null _meta: _credits: used: 1 balance: 10055812 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: messages: type: array example: - id: "400000000000000003" type: 1 dataVersion: 1 content: Message text three groupId: "200000000000000001" senderId: "300000000000000001" correlationId: "400000000000000093" inReplyTo: null inReplyToRoot: null createdAt: 1700000200 attachments: [] embeds: [] interactions: - userId: "100000000000000001" readAt: 1700000200 deliveredAt: 1700000200 likes: [] totalTipAmount: 0 - id: "400000000000000002" type: 1 dataVersion: 1 content: Message text two groupId: "200000000000000001" senderId: "300000000000000001" correlationId: "400000000000000092" inReplyTo: null inReplyToRoot: null createdAt: 1700000100 attachments: - messageId: "400000000000000002" contentType: 1 contentId: "700000000000000001" pos: 0 embeds: [] interactions: [] likes: [] totalTipAmount: 0 - id: "400000000000000001" type: 1 dataVersion: 1 content: Message text one groupId: "200000000000000001" senderId: "300000000000000001" correlationId: "400000000000000091" inReplyTo: null inReplyToRoot: null createdAt: 1700000000 attachments: [] embeds: [] interactions: [] likes: [] totalTipAmount: 0 items: type: object properties: id: type: string example: "400000000000000003" type: type: integer example: 1 dataVersion: type: integer example: 1 content: type: string example: Message text three groupId: type: string example: "200000000000000001" senderId: type: string example: "300000000000000001" correlationId: type: string example: "400000000000000093" inReplyTo: type: string example: null nullable: true inReplyToRoot: type: string example: null nullable: true createdAt: type: integer example: 1700000200 attachments: type: array example: [] embeds: type: array example: [] interactions: type: array example: - userId: "100000000000000001" readAt: 1700000200 deliveredAt: 1700000200 items: type: object properties: userId: type: string example: "100000000000000001" readAt: type: integer example: 1700000200 deliveredAt: type: integer example: 1700000200 likes: type: array example: [] totalTipAmount: type: integer example: 0 accountMedia: type: array example: - id: "700000000000000001" accountId: "300000000000000001" mediaId: "800000000000000001" previewId: null permissionFlags: 0 price: 0 createdAt: 1700000000 deletedAt: null deleted: false permissions: permissionFlags: [] accountPermissionFlags: flags: 2 metadata: "{}" likeCount: 0 media: id: "800000000000000001" type: 1 status: 1 accountId: "300000000000000001" mimetype: image/jpeg flags: 0 location: /300000000000000001/800000000000000001.jpeg width: 1080 height: 1440 metadata: '{"resolutionMode":2}' updatedAt: 1700000000 createdAt: 1700000000 variants: [] variantHash: [] locations: - locationId: "1" location: https://cdn3.fansly.com/300000000000000001/800000000000000001.jpeg purchased: false whitelisted: false accountPermissionFlags: 2 access: true items: type: object properties: id: type: string example: "700000000000000001" accountId: type: string example: "300000000000000001" mediaId: type: string example: "800000000000000001" previewId: type: string example: null nullable: true permissionFlags: type: integer example: 0 price: type: integer example: 0 createdAt: type: integer example: 1700000000 deletedAt: type: string example: null nullable: true deleted: type: boolean example: false permissions: type: object properties: permissionFlags: type: array example: [] accountPermissionFlags: type: object properties: flags: type: integer example: 2 metadata: type: string example: "{}" likeCount: type: integer example: 0 media: type: object properties: id: type: string example: "800000000000000001" type: type: integer example: 1 status: type: integer example: 1 accountId: type: string example: "300000000000000001" mimetype: type: string example: image/jpeg flags: type: integer example: 0 location: type: string example: /300000000000000001/800000000000000001.jpeg width: type: integer example: 1080 height: type: integer example: 1440 metadata: type: string example: '{"resolutionMode":2}' updatedAt: type: integer example: 1700000000 createdAt: type: integer example: 1700000000 variants: type: array example: [] variantHash: type: object properties: {} locations: type: array example: - locationId: "1" location: https://cdn3.fansly.com/300000000000000001/800000000000000001.jpeg items: type: object properties: locationId: type: string example: "1" location: type: string example: https://cdn3.fansly.com/300000000000000001/800000000000000001.jpeg purchased: type: boolean example: false whitelisted: type: boolean example: false accountPermissionFlags: type: integer example: 2 access: type: boolean example: true accountMediaBundles: type: array example: [] tips: type: array example: [] tipGoals: type: array example: [] accountMediaOrders: type: array example: [] stories: type: array example: [] storyOrders: type: array example: [] hasMore: type: boolean example: false _pagination: type: object properties: next_page: type: string example: null nullable: true _meta: type: object properties: _credits: type: object properties: used: type: integer example: 1 balance: type: integer example: 10055812 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: - Chats components: securitySchemes: default: type: http scheme: bearer description: Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys ````