---
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

## Query parameters

- `conditionFields` 'true'

## 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`.
      - `fields` EmailBlockFieldReference[] — Shape of an object field, for example the `mode`, `strategy`, `lookbackDays`, `sort`, and `filters` of a repeat block's `productSource`.
    - `example` object — A minimal valid block of this type.
    - `notes` string[]
  - `conditionFields` EmailBlockConditionFieldReference[] — The per-field table for block conditions. Returned when `type` is `conditional-group`, or when `conditionFields=true` is passed.
    - `field` string, required
    - `label` string, required
    - `operators` string[], required — The only operators this field accepts.
    - `values` string[] — Closed value set, for the fields that have one.
    - `valueFormat` string, required — How the `value` string is shaped for this field.
    - `serverEvaluated` boolean, required — Whether the field reads stored subscriber state rather than the merge data of the send.
    - `previewSupport` 'any_contact' | 'inline_tags_or_stored_subscriber' | 'stored_subscriber', required — What a render needs before it can evaluate this field. any_contact - resolved from merge data. inline_tags_or_stored_subscriber - tag, which an inline contact can state for itself. stored_subscriber - needs subscriberId. A condition a render cannot evaluate renders as false and is listed in that render's unevaluatedConditions.
    - `example` object, required — A valid condition using this field.
  - `conditionFieldsHint` string — Returned in place of `conditionFields` when the table was not included, saying that conditions are per-field and how to request the table.

## 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.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/73f826277d9a/schema)