Skip to main content
GET
/
v1
/
emails
Get emails
curl --request GET \
  --url https://brew.new/api/v1/emails \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "emailId": "eml_welcome",
      "emailVersionId": "emv_welcome_v3",
      "title": "Welcome Email",
      "status": "complete",
      "previewImage": "https://cdn.brew.new/p/eml_welcome.png",
      "updatedAt": "2026-04-08T12:34:56.789Z"
    },
    {
      "emailId": "eml_digest",
      "emailVersionId": "emv_digest_v1",
      "title": "May product digest",
      "status": "complete",
      "updatedAt": "2026-04-07T09:00:00.000Z"
    }
  ],
  "pagination": {
    "limit": 100,
    "cursor": null,
    "hasMore": false
  }
}

Authorizations

Authorization
string
header
default:Bearer brew_your_api_key
required

Send your Brew API key as Authorization: Bearer brew_xxx.

Query Parameters

emailId
string
Required string length: 1 - 64
include
string
status
enum<string>
Available options:
streaming,
complete,
error
createdAtFrom
string<date-time>
createdAtTo
string<date-time>
updatedAtFrom
string<date-time>
updatedAtTo
string<date-time>
limit
cursor
string
Required string length: 1 - 512

Response

A page of email designs (list mode), or { data: [row] } (detail mode).

data
object[]
required
pagination
object