> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mailofly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Topics

> List all email topics configured in your workspace.

Retrieve all active email topics available for preferences and contact tagging.

### Response

<ResponseField name="data" type="array">
  <ResponseField name="id" type="string">Topic ID.</ResponseField>
  <ResponseField name="name" type="string">Topic name.</ResponseField>
  <ResponseField name="description" type="string">Topic description.</ResponseField>
  <ResponseField name="defaultStatus" type="string">Default subscription status (`opt_in` or `opt_out`).</ResponseField>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://api.mailofly.com/api/v1/topics \
    -H "Authorization: Bearer mf_live_your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "top_123",
        "name": "Product Updates",
        "description": "Weekly digests on new features and product improvements",
        "defaultStatus": "opt_in"
      },
      {
        "id": "top_456",
        "name": "Promotions",
        "description": "Exclusive discounts and seasonal sales",
        "defaultStatus": "opt_out"
      }
    ]
  }
  ```
</ResponseExample>


## Related topics

- [Topics](/audience/topics.md)
- [Why use Topics?](/guides/sending/why-use-topics.md)
- [Delete Topic](/api/topics/delete-topic.md)
- [Retrieve Topic](/api/topics/retrieve-topic.md)
- [Update Topic](/api/topics/update-topic.md)