# List inbox filters

Source: https://docs.maylee.app/api-reference/inbox-filters/list-inbox-filters

`GET https://api.maylee.app/api/v1/filters`

Scope: `read`.

## Example request

```bash
curl -X GET "https://api.maylee.app/api/v1/filters" \
  -H "Authorization: Bearer $MAYLEE_KEY"
```

## Responses

### 200

Filters of the workspace.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `items` | array of InboxFilter | yes |  |
| `items[].createdAt` | string (date-time) | yes |  |
| `items[].id` | string | yes |  |
| `items[].label` | LabelRef or null | yes | The targeted label when `type` is `label`, null otherwise. |
| `items[].type` | string | yes | `sender`: exact address, case-insensitive. `domain`: sender domain such as `acme.com`. `subject`: text contained in the subject. `label`: id of a label (manual or AI) carried by the email. One of: `sender`, `domain`, `subject`, `label`. |
| `items[].updatedAt` | string (date-time) | yes |  |
| `items[].value` | string | yes |  |

```json
{
  "items": [
    {
      "createdAt": "2026-07-15T08:30:00.000Z",
      "id": "cmfl1a2b3c4d5e6f7g8h9i0j",
      "label": null,
      "type": "domain",
      "updatedAt": "2026-07-15T08:30:00.000Z",
      "value": "newsletter.example.com"
    }
  ]
}
```

### 401

Missing, malformed, revoked or expired API key.

### 403

Key lacks the required scope, or outbound sending is not enabled on it.

### 429

Per-minute rate limit (`RATE_LIMIT_EXCEEDED`) or monthly quota (`QUOTA_EXCEEDED`) exhausted.

Errors use the format `{ "code", "error", "details" }`: see [Errors](/errors.md).