> For the complete documentation index, see [llms.txt](https://developers.gamma.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.gamma.app/management/get-gamma-comments.md).

# GET /gammas/{gammaId}/comments

List comment threads on a single Gamma with cursor pagination.

## List comments on a Gamma

> Returns comment threads on a Gamma, cursor-paginated. Supports an updatedSince filter for efficient delta polling.

```json
{"openapi":"3.0.0","info":{"title":"Gamma Public API","version":"1.0"},"tags":[{"name":"public-api","description":"Public API endpoints for external integrations"}],"servers":[{"url":"https://public-api.gamma.app","description":"Production"}],"security":[{"api-key":[]}],"components":{"securitySchemes":{"api-key":{"type":"apiKey","in":"header","name":"X-API-KEY","description":"API key for authentication"}},"schemas":{"ListCommentsResponse":{"type":"object","properties":{"data":{"description":"Array of comment threads","type":"array","items":{"$ref":"#/components/schemas/CommentItem"}},"hasMore":{"type":"boolean","description":"Whether more results exist beyond this page"},"nextCursor":{"type":"string","nullable":true,"description":"Cursor for fetching the next page (null if no more results)"}},"required":["data","hasMore","nextCursor"]},"CommentItem":{"type":"object","properties":{"id":{"type":"string","description":"Unique comment identifier"},"cardId":{"type":"string","nullable":true,"description":"ID of the card this comment is attached to, or null for page-level comments"},"targetText":{"type":"string","nullable":true,"description":"Quoted snippet of the text the comment targets, as plain text"},"targetHtml":{"type":"string","nullable":true,"description":"Quoted snippet of the text the comment targets, as HTML"},"author":{"description":"Author of the comment","allOf":[{"$ref":"#/components/schemas/CommentAuthor"}]},"contentText":{"type":"string","description":"Comment content as plain text — text, @mentions, and emoji, with paragraphs\nseparated by newlines."},"status":{"type":"string","description":"Comment status: open or closed","enum":["open","closed"]},"archived":{"type":"boolean","description":"Whether the comment has been archived (deleted)"},"mentionedUsers":{"description":"Users mentioned in this comment (user IDs)","type":"array","items":{"type":"string"}},"replies":{"description":"Threaded replies to this comment","type":"array","items":{"$ref":"#/components/schemas/CommentReply"}},"createdTime":{"type":"string","description":"ISO-8601 timestamp of when the comment was created"},"updatedTime":{"type":"string","description":"ISO-8601 timestamp of when the comment was last modified"}},"required":["id","cardId","targetText","targetHtml","author","contentText","status","archived","mentionedUsers","replies","createdTime","updatedTime"]},"CommentAuthor":{"type":"object","properties":{"id":{"type":"string","description":"Unique user identifier"},"name":{"type":"string","nullable":true,"description":"Display name of the author, or null if the user has no name set"}},"required":["id","name"]},"CommentReply":{"type":"object","properties":{"id":{"type":"string","description":"Unique reply identifier"},"author":{"description":"Author of the reply","allOf":[{"$ref":"#/components/schemas/CommentAuthor"}]},"contentText":{"type":"string","description":"Reply content as plain text — text, @mentions, and emoji, with paragraphs\nseparated by newlines."},"mentionedUsers":{"description":"Users mentioned in this reply (user IDs)","type":"array","items":{"type":"string"}},"archived":{"type":"boolean","description":"Whether the reply has been archived (deleted)"},"createdTime":{"type":"string","description":"ISO-8601 timestamp of when the reply was created"},"updatedTime":{"type":"string","description":"ISO-8601 timestamp of when the reply was last modified"}},"required":["id","author","contentText","mentionedUsers","archived","createdTime","updatedTime"]}}},"paths":{"/v1.0/gammas/{gammaId}/comments":{"get":{"description":"Returns comment threads on a Gamma, cursor-paginated. Supports an updatedSince filter for efficient delta polling.","operationId":"listGammaComments","parameters":[{"name":"gammaId","required":true,"in":"path","description":"The ID of the Gamma to list comments for","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Maximum number of comments to return per page","schema":{"minimum":1,"maximum":50,"type":"number"}},{"name":"after","required":false,"in":"query","description":"Cursor for pagination (from previous response's nextCursor)","schema":{"type":"string"}},{"name":"updatedSince","required":false,"in":"query","description":"ISO-8601 timestamp cursor. When provided, only comment threads with\nactivity (including new replies) after this timestamp are returned —\nenabling efficient delta polling.","schema":{"type":"string"}},{"name":"includeArchived","required":false,"in":"query","description":"When true, archived (deleted) comments and replies are included in the\nresponse, each carrying an `archived` flag. Defaults to false.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Comments retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListCommentsResponse"}}}},"400":{"description":"Invalid request parameters (e.g. malformed updatedSince)"},"401":{"description":"Invalid or missing API key"},"403":{"description":"Insufficient permissions — caller must have comment-level access"},"404":{"description":"Gamma not found"}},"summary":"List comments on a Gamma","tags":["public-api"]}}}}
```

{% hint style="info" %}
Requires comment-level access on the Gamma. Use `limit` (1–50) and `after` to paginate. Pass `updatedSince` (ISO-8601) to fetch only comment threads with activity (including new replies) after that timestamp. Set `includeArchived` to `true` to include archived (deleted) comments and replies.
{% endhint %}

## Related

* [GET /gammas/{gammaId}](/management/get-gamma.md) for title, thumbnail, and URL metadata
* [Poll for results](/guides/async-patterns-and-polling.md) for polling patterns that also apply to `updatedSince` delta sync
* [Use themes and folders](/guides/list-themes-and-list-folders-apis-explained.md) for cursor-pagination patterns used by `after`
* [Error codes](/reference/error-codes.md) for authentication and permission failures


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.gamma.app/management/get-gamma-comments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.