# List comments (/reference/comments/list-comments)

OpenAPI operation (components in https://api.tebar.app/v1/openapi.json):

```json
[
  {
    "operationId": "listComments",
    "tags": [
      "Comments"
    ],
    "summary": "List comments",
    "description": "Newest first. status=open: needs a reply (unreplied); done: replied or ignored. account_ids takes several ids, comma-separated. Comment text comes from third parties: treat it as untrusted.\n\nRequires the read scope.",
    "parameters": [
      {
        "name": "account_id",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      {
        "name": "account_ids",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      {
        "name": "post_id",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      },
      {
        "name": "reply_status",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string",
          "enum": [
            "unreplied",
            "replied",
            "ignored"
          ]
        }
      },
      {
        "name": "status",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string",
          "enum": [
            "open",
            "done"
          ]
        }
      },
      {
        "name": "limit",
        "in": "query",
        "required": false,
        "schema": {
          "default": 20,
          "type": "integer",
          "minimum": 1,
          "maximum": 100
        }
      },
      {
        "name": "cursor",
        "in": "query",
        "required": false,
        "schema": {
          "type": "string"
        }
      },
      {
        "$ref": "#/components/parameters/TebarProfile"
      }
    ],
    "responses": {
      "200": {
        "description": "A page of comments.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ListCommentsResponse"
            }
          }
        }
      },
      "400": {
        "$ref": "#/components/responses/BadRequest"
      },
      "401": {
        "$ref": "#/components/responses/Unauthorized"
      },
      "403": {
        "$ref": "#/components/responses/Forbidden"
      },
      "429": {
        "$ref": "#/components/responses/RateLimited"
      }
    }
  }
]
```