List Chat Messages

Get a list of chat messages for a connected OnlyFans account, sorted by newest first.

https://v1.onlyfansapi.io

GET

/api/{acct_id}/chats/{user_id}/messages

Request

curl --request GET \
  --url 'https://v1.onlyfansapi.io/api/{acct_id}/chats/{user_id}/messages' \
  --header 'x-api-key: YOUR_API_KEY'

Headers

x-api-key*

string

Your API key. See Authentication.

Path Parameters

acct_id*

string

The connected account to read from, as returned by Authenticate Account.

user_id*

string

The OnlyFans user to read the chat with, as returned in withUser.id by List Chats.

Response

{
    "data": [
        {
            "responseType": "message",
            "text": "<p>Hey babe, here is the set you asked for 😘</p>",
            "giphyId": null,
            "lockedText": false,
            "isFree": false,
            "price": 25,
            "isMediaReady": true,
            "mediaCount": 13,
            "media": [
                {
                    "id": 1000000001,
                    "type": "gif",
                    "convertedToVideo": true,
                    "canView": true,
                    "hasError": false,
                    "createdAt": null,
                    "isReady": true,
                    "files": {
                        "full": {
                            "url": "https://cdn2.onlyfans.com/files/e/ex/example_media_hash/example_source.mp4?Tag=2&u=123456789&Policy=example_policy&Signature=example_signature&Key-Pair-Id=EXAMPLEKEYPAIRID",
                            "width": 594,
                            "height": 1056,
                            "size": 0,
                            "sources": []
                        },
                        "thumb": {
                            "url": "https://cdn2.onlyfans.com/files/e/ex/example_thumb_hash/150x150_example_frame_0.jpg?Tag=2&u=123456789&Policy=example_policy&Signature=example_signature&Key-Pair-Id=EXAMPLEKEYPAIRID",
                            "width": 150,
                            "height": 150,
                            "size": 0
                        },
                        "preview": {
                            "url": "https://cdn2.onlyfans.com/files/e/ex/example_preview_hash/594x1056_example_frame_0.jpg?Tag=2&u=123456789&Policy=example_policy&Signature=example_signature&Key-Pair-Id=EXAMPLEKEYPAIRID",
                            "width": 594,
                            "height": 1056,
                            "size": 0
                        },
                        "squarePreview": {
                            "url": "https://cdn2.onlyfans.com/files/e/ex/example_square_hash/960x960_example_frame_0.jpg?Tag=2&u=123456789&Policy=example_policy&Signature=example_signature&Key-Pair-Id=EXAMPLEKEYPAIRID",
                            "width": 960,
                            "height": 960,
                            "size": 0
                        }
                    },
                    "duration": 3,
                    "hasCustomPreview": false,
                    "videoSources": {
                        "240": null,
                        "720": null
                    }
                },
                {
                    "id": 1000000002,
                    "type": "photo",
                    "convertedToVideo": false,
                    "canView": false,
                    "hasError": false,
                    "createdAt": null,
                    "isReady": true,
                    "files": {
                        "full": {
                            "url": null,
                            "width": 3024,
                            "height": 4032,
                            "size": 0,
                            "sources": []
                        }
                    },
                    "duration": 0
                },
                {
                    "id": 1000000003,
                    "type": "video",
                    "convertedToVideo": false,
                    "canView": false,
                    "hasError": false,
                    "createdAt": null,
                    "isReady": true,
                    "files": {
                        "full": {
                            "url": null,
                            "width": 594,
                            "height": 1056,
                            "size": 0,
                            "sources": []
                        }
                    },
                    "duration": 119
                }
            ],
            "previews": [
                1000000001
            ],
            "isTip": false,
            "isReportedByMe": false,
            "isCouplePeopleMedia": false,
            "queueId": 10000000001,
            "isMarkdownDisabled": true,
            "fromUser": {
                "view": "s",
                "avatar": "https://public.onlyfans.com/files/e/ex/example_avatar_hash/123456789/avatar.png",
                "avatarThumbs": {
                    "c50": "https://thumbs.onlyfans.com/public/files/thumbs/c50/e/ex/example_avatar_hash/123456789/avatar.png",
                    "c144": "https://thumbs.onlyfans.com/public/files/thumbs/c144/e/ex/example_avatar_hash/123456789/avatar.png"
                },
                "header": "https://public.onlyfans.com/files/e/ex/example_header_hash/123456789/header.png",
                "headerSize": {
                    "width": 1920,
                    "height": 1080
                },
                "headerThumbs": {
                    "w480": "https://thumbs.onlyfans.com/public/files/thumbs/w480/e/ex/example_header_hash/123456789/header.png",
                    "w760": "https://thumbs.onlyfans.com/public/files/thumbs/w760/e/ex/example_header_hash/123456789/header.png"
                },
                "id": 123456789,
                "name": "Example User",
                "username": "exampleuser",
                "canLookStory": true,
                "canCommentStory": true,
                "hasNotViewedStory": false,
                "isVerified": true,
                "canPayInternal": true,
                "hasScheduledStream": true,
                "hasStream": false,
                "hasStories": false,
                "tipsEnabled": true,
                "tipsTextEnabled": true,
                "tipsMin": 5,
                "tipsMinInternal": 1,
                "tipsMax": 200,
                "canEarn": true,
                "canAddSubscriber": false,
                "subscribePrice": 0,
                "displayName": "",
                "isPaywallRequired": true,
                "isActive": true,
                "isRestricted": false,
                "canRestrict": true,
                "subscribedBy": true,
                "subscribedByExpire": false,
                "subscribedByExpireDate": "2036-09-20T18:57:06+00:00",
                "subscribedByAutoprolong": true,
                "subscribedIsExpiredNow": false,
                "currentSubscribePrice": 0,
                "subscribedOn": null,
                "subscribedOnExpire": null,
                "subscribedOnExpiredNow": null,
                "subscribedOnDuration": null,
                "listsStates": [
                    {
                        "id": "fans",
                        "type": "fans",
                        "name": "Fans",
                        "hasUser": false,
                        "canAddUser": false,
                        "cannotAddUserReason": null
                    },
                    {
                        "id": "following",
                        "type": "following",
                        "name": "Following",
                        "hasUser": true,
                        "canAddUser": false,
                        "cannotAddUserReason": "ALREADY_EXISTS"
                    },
                    {
                        "id": "recent",
                        "type": "recent",
                        "name": "Recent (last 24 hours)",
                        "hasUser": false,
                        "canAddUser": false,
                        "cannotAddUserReason": "SYSTEM_LIST"
                    }
                ],
                "showMediaCount": true,
                "lastSeen": "2026-09-20T22:29:14+00:00",
                "canReport": true,
                "isDeleted": false
            },
            "isFromQueue": true,
            "canUnsendQueue": true,
            "unsendSecondsQueue": 1000000,
            "id": 11000000000001,
            "isOpened": false,
            "isNew": true,
            "createdAt": "2026-09-20T21:53:13+00:00",
            "changedAt": "2026-09-20T21:53:13+00:00",
            "cancelSeconds": 1000000,
            "isLiked": false,
            "canPurchase": true,
            "canPurchaseReason": "",
            "canReport": true,
            "canBePinned": true,
            "isPinned": false,
            "isAddedToBookmarks": false,
            "chatUserId": 123456789
        },
        {
            "responseType": "message",
            "text": "hi there",
            "giphyId": null,
            "lockedText": false,
            "isFree": true,
            "price": 0,
            "isMediaReady": true,
            "mediaCount": 0,
            "media": [],
            "previews": [],
            "isTip": false,
            "isReportedByMe": false,
            "isCouplePeopleMedia": false,
            "queueId": 10000000002,
            "isMarkdownDisabled": true,
            "fromUser": {
                "view": "s",
                "avatar": "https://public.onlyfans.com/files/e/ex/example_avatar_hash/123456789/avatar.png",
                "avatarThumbs": {
                    "c50": "https://thumbs.onlyfans.com/public/files/thumbs/c50/e/ex/example_avatar_hash/123456789/avatar.png",
                    "c144": "https://thumbs.onlyfans.com/public/files/thumbs/c144/e/ex/example_avatar_hash/123456789/avatar.png"
                },
                "header": "https://public.onlyfans.com/files/e/ex/example_header_hash/123456789/header.png",
                "headerSize": {
                    "width": 1920,
                    "height": 1080
                },
                "headerThumbs": {
                    "w480": "https://thumbs.onlyfans.com/public/files/thumbs/w480/e/ex/example_header_hash/123456789/header.png",
                    "w760": "https://thumbs.onlyfans.com/public/files/thumbs/w760/e/ex/example_header_hash/123456789/header.png"
                },
                "id": 123456789,
                "name": "Example User",
                "username": "exampleuser",
                "canLookStory": true,
                "canCommentStory": true,
                "hasNotViewedStory": false,
                "isVerified": true,
                "canPayInternal": true,
                "hasScheduledStream": true,
                "hasStream": false,
                "hasStories": false,
                "tipsEnabled": true,
                "tipsTextEnabled": true,
                "tipsMin": 5,
                "tipsMinInternal": 1,
                "tipsMax": 200,
                "canEarn": true,
                "canAddSubscriber": false,
                "subscribePrice": 0,
                "displayName": "",
                "isPaywallRequired": true,
                "isActive": true,
                "isRestricted": false,
                "canRestrict": true,
                "subscribedBy": true,
                "subscribedByExpire": false,
                "subscribedByExpireDate": "2036-09-20T18:57:06+00:00",
                "subscribedByAutoprolong": true,
                "subscribedIsExpiredNow": false,
                "currentSubscribePrice": 0,
                "subscribedOn": null,
                "subscribedOnExpire": null,
                "subscribedOnExpiredNow": null,
                "subscribedOnDuration": null,
                "listsStates": [
                    {
                        "id": "fans",
                        "type": "fans",
                        "name": "Fans",
                        "hasUser": false,
                        "canAddUser": false,
                        "cannotAddUserReason": null
                    },
                    {
                        "id": "following",
                        "type": "following",
                        "name": "Following",
                        "hasUser": true,
                        "canAddUser": false,
                        "cannotAddUserReason": "ALREADY_EXISTS"
                    },
                    {
                        "id": "recent",
                        "type": "recent",
                        "name": "Recent (last 24 hours)",
                        "hasUser": false,
                        "canAddUser": false,
                        "cannotAddUserReason": "SYSTEM_LIST"
                    }
                ],
                "showMediaCount": true,
                "lastSeen": "2026-09-20T22:29:14+00:00",
                "canReport": true,
                "isDeleted": false
            },
            "isFromQueue": false,
            "id": 11000000000002,
            "isOpened": false,
            "isNew": true,
            "createdAt": "2026-09-20T18:58:16+00:00",
            "changedAt": "2026-09-20T18:58:16+00:00",
            "cancelSeconds": 73534,
            "isLiked": false,
            "canPurchase": false,
            "canPurchaseReason": "free",
            "canReport": true,
            "canBePinned": true,
            "isPinned": false,
            "isAddedToBookmarks": false,
            "chatUserId": 123456789
        }
    ],
    "meta": {
        "hasMore": true
    }
}