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

# List Chat Messages

`GET /api/{account}/chats/{chat_id}/messages`

Get messages from a specific chat.

## Query parameters

- `limit` string — The number of messages to return (default = 10, max = 100)
- `filter` 'pinned' — Filter by certain messages. Currently, only pins are filterable.
- `first_id` string, nullable — Use for pagination when `order=desc` (newest to oldest). Include this message ID as the first message in the results. Used to retrieve messages from e.g. the Search Chat Messages endpoint IDs.
- `last_id` string, nullable — Use for pagination when `order=asc` (oldest to newest). Include this message ID as the first message in the results. WARNING! The response list of messages will also be inverted (oldest messages will be first, opposite to default where `order=desc`).
- `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` integer
    - `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
  - `_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

---

[API](https://skmtc.net/onlyfansapi/apis/onlyfans-api.md) · [All operations](https://skmtc.net/onlyfansapi/apis/onlyfans-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onlyfansapi/onlyfans-api/versions/4a99d36f28a3/schema)