---
title: "Get email block type"
method: GET
path: "/email-blocks/{type}"
tags: ["Email Blocks"]
---

# Get email block type

`GET /email-blocks/{type}`

Returns the full field reference for one block type, with a minimal valid example and authoring notes.

## Path parameters

- `type` string, required

## Response `200`

Block type reference

- object
  - `success` boolean
  - `blockType` EmailBlockTypeReference — Field reference for one email block type. 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`.
    - `type` string
    - `creatable` boolean — False for structural types the editor manages, which should not be hand-authored.
    - `reason` string — Why a non-creatable type is excluded.
    - `required` string[]
    - `optional` string[]
    - `fields` EmailBlockFieldReference[]
      - `name` string
      - `required` boolean
      - `type` string — Value shape, for example string, number, boolean, enum, array, or object.
      - `values` unknown[] — Allowed values, for enum and literal-union fields.
        - unknown
      - `itemFields` EmailBlockFieldReference[] — Shape of one entry in an array field. This is where `list` and `steps` differ: list items carry `content`, steps items carry `title` and an optional `description`.
    - `example` object — A minimal valid block of this type.
    - `notes` string[]

## Other responses

- `401` — Unauthorized
- `404` — Unknown block type
- `503` — The database was temporarily unavailable. The request may be retried after the delay in Retry-After.

---

[API](https://skmtc.net/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.net/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/8fbabe82a04d/schema)