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

# List Email Components

> List reusable email components, including the components pinned as company defaults.

# List Email Components

You can list the company's reusable email components, newest first. Components are saved block groups you can reuse across emails, plus the components pinned as a company default for a slot.

## Request

<ParamField query="type" type="string">
  Filter by component type: `section` or `footer`.
</ParamField>

<ParamField query="slot" type="string">
  Filter by default slot. Currently only `footer`.
</ParamField>

<ParamField query="defaultsOnly" type="string">
  Pass `true` to return only components pinned as a company default.
</ParamField>

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/email-components?defaultsOnly=true" \
  -H "Authorization: Bearer API_KEY"
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "components": [
      {
        "id": "cmp_123",
        "companyId": "comp_123",
        "name": "Default Footer",
        "description": null,
        "blocks": [{ "id": "block_1", "type": "footer", "variant": "full" }],
        "componentType": "footer",
        "defaultSlot": "footer",
        "version": 3,
        "createdAt": "2026-01-10T10:00:00.000Z",
        "updatedAt": "2026-08-01T09:30:00.000Z"
      }
    ]
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": "Unsupported slot: header. Supported slots: footer"
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Invalid API key"
  }
  ```
</ResponseExample>

## Related

* [Get Default Email Component](/api-reference/email-components/get-default)