---
title: "List messages"
method: GET
path: "/v1/developer/projects/{project_id}/messages/"
tags: ["Messages"]
---

# List messages

`GET /v1/developer/projects/{project_id}/messages/`

## Request

- Base URL: `https://screensdesign.com`
- URL: `https://screensdesign.com/v1/developer/projects/{project_id}/messages/`
- Auth: HTTP bearer

List the conversation history for a project's default chat. Returns user prompts and assistant responses in chronological order. Assistant messages that created screens include the screens inline. Hidden setup messages are filtered out.

The response includes the `chat_id` at the top level (and on each message), so callers can correlate messages with their parent chat.

## Path parameters

- `project_id` integer, required

## Response `200`

Conversation messages in chronological order, scoped to the project's default chat.

- object

## Other responses

- `401`: Missing or invalid API key.
- `403`: Your API key is missing the required scope for this endpoint.
- `404`: The requested resource doesn't exist or doesn't belong to your organization.
- `429`: Rate limit exceeded. Wait and retry.

---

[API](https://skmtc.dev/screensdesign/apis/screensdesign-create-developer-api.md) · [All operations](https://skmtc.dev/screensdesign/apis/screensdesign-create-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/screensdesign/apis/screensdesign-create-developer-api/revisions/8c2fab15e11c?raw)