---
search:
  tags:
    - Topics
    - GET
seo:
  description: >-
    List topics (issues) with filters, message counts, and authors. When
    embeddingSearch is provided,… Reference for the GET /topics endpoint in the
    Modem API.
sidebar:
  label: List topics
  badge: GET
title: List topics
type: openapi-operation
---
List topics (issues) with filters, message counts, and authors. When embeddingSearch is provided, performs semantic search using vector similarity instead of keyword search. Semantic search finds topics by meaning, useful for queries like "users having trouble with authentication".

`GET /topics`

**Responses**

- `200` — OK
- `400` — Invalid request (validation failed).
- `401` — Missing or invalid API key.
- `403` — The API key does not have access to this resource.
- `404` — The requested resource was not found.
- `429` — Rate limit exceeded.
- `500` — Internal server error.

Response example, 200:

```json
{
  "data": [
    {
      "authors": [
        {
          "displayName": "string",
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "isBot": true,
          "sourceAuthorId": "string",
          "sourceAvatarUrl": "http://example.com",
          "sourceName": "string"
        }
      ],
      "eventCount": 0,
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "issueType": "bug_report",
      "keywords": [
        "string"
      ],
      "lifecycleState": "completed",
      "lifecycleStateConfidence": 0,
      "linkedTicket": {
        "displayName": "string",
        "linkType": "issue",
        "url": "http://example.com"
      },
      "messageCount": 0,
      "persons": [
        {
          "avatarUrl": "string",
          "company": {
            "domain": "string",
            "id": "string",
            "isOrgCompany": true,
            "logoUrl": "string",
            "name": "string"
          },
          "displayName": "string",
          "id": "string",
          "isBot": true,
          "isStaff": true
        }
      ],
      "priority": "default",
      "similarity": 0,
      "sources": [
        "string"
      ],
      "staffResponseGroupCount": 0,
      "summary": "string",
      "timeRangeEnd": null,
      "timeRangeStart": null,
      "title": "string",
      "totalGroupCount": 0,
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "limit": 1,
  "page": 1,
  "totalCount": 0
}
```