---
title: "List Pinned Chat Messages"
method: GET
path: "/api/{account}/chats/{chat_id}/messages/pinned"
tags: ["Chat Messages"]
---

# List Pinned Chat Messages

`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

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

Returns the same message objects and pagination as [List Chat Messages](https://docs.onlyfansapi.com/api-reference/chat-messages/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](https://docs.onlyfansapi.com/api-reference/chat-messages/pin-message) or [Unpin Message](https://docs.onlyfansapi.com/api-reference/chat-messages/unpin-message) to change the pin state.

## Query parameters

- `limit` string: The number of messages to return (default = 10, max = 100)
- `first_id` string, 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_id` string, 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.
- `order` string: Sort order for messages (desc or asc)
- `skip_users` string: Whether to skip user details (`all` or `none`).

## Response `200`

Success

- object
  - `data` object[]
    - `responseType` string
    - `text` string
    - `giphyId` string, nullable
    - `lockedText` boolean
    - `isFree` boolean
    - `price` integer
    - `isMediaReady` boolean
    - `mediaCount` integer
    - `media` unknown[]
      - unknown
    - `previews` unknown[]
      - unknown
    - `isTip` boolean
    - `isReportedByMe` boolean
    - `isCouplePeopleMedia` boolean
    - `queueId` string, nullable
    - `isMarkdownDisabled` boolean
    - `releaseForms` unknown[]
      - unknown
    - `fromUser` object
      - `id` integer
      - `_view` string
    - `isFromQueue` boolean
    - `id` integer
    - `isOpened` boolean
    - `isNew` boolean
    - `createdAt` string
    - `changedAt` string
    - `cancelSeconds` integer
    - `isLiked` boolean
    - `canPurchase` boolean
    - `canPurchaseReason` string
    - `canReport` boolean
    - `canBePinned` boolean
    - `isPinned` boolean
    - `isSentByMe` boolean
    - `seenByFan` boolean, nullable, required: For messages sent by the connected account, true if the fan has seen the message and false otherwise. Null for messages sent by the fan or when read status is unavailable.
  - `_pagination` object
    - `next_page` string
  - `_meta` object
    - `_credits` object
      - `used` integer
      - `balance` integer
      - `note` string
    - `_cache` object
      - `is_cached` boolean
      - `note` string
    - `_rate_limits` object
      - `limit_minute` integer
      - `limit_day` integer
      - `remaining_minute` integer
      - `remaining_day` integer

## Changes

- **2026-10-25** `11e906c7aedb`: 1 info
  - added the required property `data/items/seenByFan` to the response with the `200` status
- **2026-10-17** `b3968f1bc1f0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/changes/api/:account/chats/:chat_id/messages/pinned/get.md)

---

[API](https://skmtc.dev/onlyfansapi/apis/onlyfans-api.md) - [All operations](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/revisions/122c36386896?raw)