Skip to main content
GET
Get a contact

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

Path Parameters

email
string<email>
required

The contact’s email address (URL-encoded). Email is the contact primary key.

Example:

"jane%40example.com"

Response

The contact row.

email
string<email>
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
firstName
string
lastName
string
subscribed
boolean
default:true
validationStatus
enum<string>
Available options:
valid,
risky,
invalid
verificationStatus
enum<string>

Deprecated: legacy mirror of validationStatus. Will be removed; read validationStatus.

Available options:
valid,
risky,
invalid
suppressed
boolean
default:false
suppressedReason
string | null
lastValidatedAt
string<date-time>
validationDetails
object
importId
string | null
csvFileName
string | null
customFields
object