Sequence Emails

List sequence emails

Returns every email inside a sequence, ordered by position (the order subscribers receive them). Each entry carries timing (delay_value, delay_unit, send_days), publish state (published), and metadata (subject, preview_text, email_template_id).

Tip: the heavier content field is omitted by default to keep responses fast on sequences with many emails. Pass include_content=true when you need the body — for example, to render a preview, audit Liquid usage, or sync an external draft.

For the field semantics — particularly how delay_unit and send_days interact, and what happens when subscribers hit a published: false email — see Create a sequence email.

get/v4/sequences/{sequence_id}/emails

Request

  • Base URL
    https://api.kit.com
  • URL
    https://api.kit.com/v4/sequences/{sequence_id}/emails
  • Auth
    • API key in header X-Kit-Api-Key
    • or OAuth 2
      Authorization code: https://api.kit.com/v4/oauth/authorize
      Token URL: https://api.kit.com/v4/oauth/token

Path parameters

sequence_idinteger required

Query parameters

afterunknown

To fetch next page of results, use ?after=<end_cursor>

beforeunknown

To fetch previous page of results, use ?before=<start_cursor>

include_contentunknown

Pass true to include the content field on each email in the response. Omitted by default because it increases response size for large sequences.

include_total_countboolean

Set to true to include the total_count in the response. This option can cause slow responses; if paging through results, request it only on the first page and reuse the value for subsequent pages.

per_pageunknown

Number of results per page. Default 500, maximum 1000.

includestring

Comma-separated list of additional data to include on each email. Valid options: stats. stats adds a stats object with per-email deliverability counts and rates (opens, clicks, bounces, complaints, unsubscribes), matching the numbers shown on the sequence report.

Response

Returns a paginated list of all sequence emails for your account

Changes

No recorded changes to this operation across all 2 revisions of this API.