Get emails
Unified email-design read. Omit emailId to LIST the brand’s designs (newest first) under { data, pagination } — each row carries emailId, the latest emailVersionId, title, status, previewImage (when captured), and updatedAt. Filter with ?status= and the createdAtFrom/To + updatedAtFrom/To ISO-8601 windows; paginate with limit + cursor. Pass ?emailId= to fetch ONE design — returns { data: [row] } (no pagination), 404 EMAIL_NOT_FOUND on an unknown / cross-brand id. Add detail-only ?include=html (rendered HTML) and/or ?include=versions (lean { version, emailVersionId } history) — both rejected without emailId.
Authorizations
Send your Brew API key as Authorization: Bearer brew_xxx.
Headers
The brand this request acts on. REQUIRED for organization-scoped credentials (otherwise 400 BRAND_ID_REQUIRED — there is no default brand); list ids with GET /v1/brands. Brand-scoped credentials may omit it, and sending a different brand returns 403 BRAND_SCOPE_MISMATCH. A brand outside your organization returns 404 BRAND_NOT_FOUND.
1 - 64Query Parameters
1 - 64streaming, complete, error 1 - 512