ONonlyfansapi
Chat Messages

List Pinned Chat Messages

Changed on

Get pinned messages from a specific chat. Requires API-key read permission.

Returns the same message objects and pagination as List Chat Messages. The pinned filter is always applied and cannot be overridden. The original filter=pinned listing remains supported.

Use isPinned for the current pin state and canBePinned for pin eligibility in the standard message response. Follow _pagination.next_page until it is null; a short page can still have more results. For messages sent by the connected account, seenByFan is true if the fan has seen the message and false otherwise. It is null for messages sent by the fan or when read status is unavailable.

Use Pin Message or Unpin Message to change the pin state.

get/api/{account}/chats/{chat_id}/messages/pinned

Request

  • Base URL
    https://app.onlyfansapi.com
  • URL
    https://app.onlyfansapi.com/api/{account}/chats/{chat_id}/messages/pinned
  • Auth
    HTTP bearer

Query parameters

limitstring

The number of messages to return (default = 10, max = 100)

first_idstring nullable

Use for pagination when order=desc (newest to oldest). Pass the last message ID from the previous page to retrieve older messages, excluding that cursor message.

last_idstring nullable

Use for pagination when order=asc (oldest to newest). Include this message ID as the first message in the results. The response is ordered oldest first.

orderstring

Sort order for messages (desc or asc)

Example:desc
skip_usersstring

Whether to skip user details (all or none).

Example:all

Response

Success

Example response

{
  "data": [
    {
      "responseType": "message",
      "text": "<p>Example pinned message</p>",
      "giphyId": null,
      "lockedText": false,
      "isFree": true,
      "price": 0,
      "isMediaReady": true,
      "mediaCount": 0,
      "media": [],
      "previews": [],
      "isTip": false,
      "isReportedByMe": false,
      "isCouplePeopleMedia": false,
      "queueId": null,
      "isMarkdownDisabled": true,
      "releaseForms": [],
      "fromUser": {
        "id": 987654321,
        "_view": "s"
      },
      "isFromQueue": false,
      "id": 1234567890123,
      "isOpened": false,
      "isNew": true,
      "createdAt": "2025-09-02T21:02:18+00:00",
      "changedAt": "2025-09-02T21:02:18+00:00",
      "cancelSeconds": 0,
      "isLiked": false,
      "canPurchase": false,
      "canPurchaseReason": "free",
      "canReport": false,
      "canBePinned": true,
      "isPinned": true,
      "isSentByMe": true,
      "seenByFan": false
    }
  ],
  "_pagination": {
    "next_page": "https://app.onlyfansapi.com/api/acct_ANONYMIZED_ACCOUNT_ID/chats/987654321/messages/pinned?limit=10&order=desc&first_id=1234567890123"
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 224891,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 999,
      "remaining_day": 49984
    }
  }
}

Changes