> ## 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 Block Types

> List every email block type with its required and optional fields.

# List Email Block Types

You can list every block type accepted by the `blocks` array on campaigns, sequence email steps, templates, transactional emails, and email components. Each entry names the required and optional fields, the allowed values of every enum field, and the shape of nested item arrays.

This reference is derived from the same schemas that validate a write, so it cannot drift from what those endpoints accept.

## Request

<ParamField query="creatableOnly" type="string">
  Pass `true` to hide structural block types the editor manages for you, such as
  `conditional-group` and `footer`.
</ParamField>

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

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "blockTypes": [
      {
        "type": "list",
        "creatable": true,
        "required": ["variant", "items"],
        "optional": ["id", "color", "styles", "conditions"],
        "fields": [
          {
            "name": "variant",
            "required": true,
            "type": "enum",
            "values": ["bullet", "numbered", "checklist"]
          },
          {
            "name": "items",
            "required": true,
            "type": "array",
            "itemFields": [
              { "name": "id", "required": false, "type": "string" },
              { "name": "content", "required": true, "type": "string" },
              { "name": "color", "required": false, "type": "string" }
            ]
          }
        ],
        "example": {
          "type": "list",
          "variant": "bullet",
          "items": [{ "content": "First point" }, { "content": "Second point" }]
        },
        "notes": ["Variants: \"bullet\", \"numbered\", or \"checklist\"."]
      }
    ]
  }
  ```

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

## Authoring notes

Lists are their own block type rather than a text variant. A `text` block accepts only `variant: "paragraph"`, `"lead"`, or `"html"`, and never accepts `items`.

```json theme={null}
{ "type": "list", "variant": "numbered", "items": [{ "content": "First" }] }
{ "type": "steps", "variant": "numbered", "items": [{ "title": "Step one", "description": "What happens" }, { "title": "Step two", "description": "What happens next" }] }
```

Use `list` for a plain numbered or bulleted list, and `steps` for a visual numbered walkthrough. List items carry `content`; steps items carry `title` and an optional `description`.

## Related

* [Get Email Block Type](/api-reference/email-blocks/get)
* [Visual Blocks](/concepts/visual-blocks)