> ## Documentation Index
> Fetch the complete documentation index at: /docs/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 via the Mailofly API.

### Response

**data** `array`

**id** `string`

Topic ID.

**name** `string`

Topic name.

**description** `string`

Topic description.

**defaultStatus** `string`

Default subscription status (`opt_in` or `opt_out`).

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

```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"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.