---
title: "List messages of a conversation"
method: GET
path: "/api/projects/{id}/conversations/{convId}/messages"
tags: ["Conversations"]
---

# List messages of a conversation

`GET /api/projects/{id}/conversations/{convId}/messages`

## Request

- Base URL: `https://dosai.pro`
- URL: `https://dosai.pro/api/projects/{id}/conversations/{convId}/messages`
- Auth: HTTP bearer

Ordered by real send time, so re-synced history interleaves correctly with live turns.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Messages page.

- object
  - `data` Message[], required
    - `id` string, uuid, required
    - `role` 'user' | 'assistant' | 'system', required
    - `content` string, nullable
    - `message_type` string: `operator` marks a human reply; other values describe media.
    - `media_url` string, nullable
    - `reply_to_message_id` string, uuid, nullable
    - `created_at` string, date-time
  - `pagination` Pagination: Offset mode returns page/limit/total/pages; keyset mode (deep lead pages) returns mode/limit/has_more/next_before. The functions list uses offset/limit/total/has_more instead of page numbers.
    - `mode` 'offset' | 'keyset'
    - `page` integer
    - `limit` integer
    - `total` integer
    - `pages` integer: Total number of pages in offset mode.
    - `offset` integer
    - `has_more` boolean
    - `next_before` string, date-time, nullable

## Other responses

- `401`: Missing, invalid, expired or revoked key.
- `403`: Not allowed. Distinguish by `code`: `INSUFFICIENT_SCOPE` (read-only key attempted a mutation), `API_KEY_PROJECT_SCOPE` (project-scoped key reached outside its project), `FORBIDDEN` (the user's role on this project is too low), `ACCOUNT_BANNED`.
- `404`: No such resource, or it belongs to another account.
- `429`: Too many requests. 120/min per key overall, plus a stricter per-endpoint budget. Retry after the number of seconds in Retry-After.

---

[API](https://skmtc.dev/dosai/apis/dos-ai-public-api.md) · [All operations](https://skmtc.dev/dosai/apis/dos-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dosai/apis/dos-ai-public-api/revisions/38ce5f4e8f50?raw)