---
title: "Retrieve a thread's read status"
method: GET
path: "/api/v1/threads/{thread}/read_status"
---

# Retrieve a thread's read status

`GET /api/v1/threads/{thread}/read_status`

Returns the read status of a thread for the specified user, including the ID
of the last message they have read and the number of unread messages remaining.

For user-authenticated requests, the status is always returned for the
authenticated user and the `user` parameter is ignored. For server-to-server
(S2S) requests, the `user` parameter is required and must be a valid user ID.

Returns 404 if the thread does not exist or the caller does not have access
to it.

## Path parameters

- `thread` string, required

## Query parameters

- `user` string

## Response `200`

Successful response

- ThreadReadStatus — The read status of a thread for a specific user, indicating how far they have read and how many messages remain unread.
  - `last_read_message` string — Message ID (`msg_...`) of the last message the user has read in this thread. `null` if the user has never read any message in the thread.
  - `thread` string, required — Thread ID (`thr_...`) that this read status belongs to.
  - `unread_count` integer, required — Number of messages in the thread that the user has not yet read.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Thread not found

---

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