Get the brand bound to this API key

curl --request GET \
  --url https://brew.new/api/v1/brand \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://brew.new/api/v1/brand', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://brew.new/api/v1/brand",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://brew.new/api/v1/brand"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://brew.new/api/v1/brand")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "brandId": "kx7b3s7fapqz8mjm12ekz1kxdx87yceg",
  "domain": "vercel.com",
  "status": "completed",
  "ready": true,
  "createdAt": "2026-04-08T12:00:00.000Z",
  "updatedAt": "2026-04-08T12:05:00.000Z",
  "identity": {
    "brandName": "Vercel",
    "tagline": "Develop. Preview. Ship."
  }
}

Brand

Get the brand bound to this API key

Returns { brand } — the single brand bound to the API key. Check ready (status === "completed") before calling POST /v1/emails, which returns 422 BRAND_NOT_READY until brand extraction finishes.

Embed the design context in the same call with ?include=identity,emailDesign,imageStyle,logos (comma-separated). identity is the structured brand facts; emailDesign / imageStyle are the markdown design system the email agent follows; logos is the CDN logo set. The paginated image library is a separate read (GET /v1/brand/images).

GET

brand

curl --request GET \
  --url https://brew.new/api/v1/brand \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://brew.new/api/v1/brand', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://brew.new/api/v1/brand",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://brew.new/api/v1/brand"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://brew.new/api/v1/brand")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "brandId": "kx7b3s7fapqz8mjm12ekz1kxdx87yceg",
  "domain": "vercel.com",
  "status": "completed",
  "ready": true,
  "createdAt": "2026-04-08T12:00:00.000Z",
  "updatedAt": "2026-04-08T12:05:00.000Z",
  "identity": {
    "brandName": "Vercel",
    "tagline": "Develop. Preview. Ship."
  }
}

Authorizations

Authorization

string

header

default:Bearer brew_your_api_key

required

Send your Brew API key as Authorization: Bearer brew_xxx.

Headers

X-Brand-Id

string

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.

Required string length: 1 - 64

Query Parameters

include

string

Comma-separated sub-resources to embed: identity, emailDesign, imageStyle, logos.

Response

The brand bound to this API key, plus any sub-resources named in ?include=.

brandId

string

required

Minimum string length: 1

domain

string

required

Minimum string length: 1

status

enum<string>

required

Available options:

extracting,

completed,

failed,

deleting

ready

boolean

required

progress

integer

Required range: 0 <= x <= 100

phase

string

error

string

createdAt

string<date-time>

updatedAt

string<date-time>

identity

object

Show child attributes

emailDesign

string

imageStyle

string

logos

object[]

Show child attributes

Start Here

REST API

API Contracts

API Guides

MCP server

CLI

SDK Overview

TypeScript SDK

Public API v1

Get the brand bound to this API key

Authorizations

Headers

Query Parameters

Response