Skip to main content

Brand lookup

GET /v1/brand

Resolve a catalog service from a domain name or a business email address. Pass exactly one of domain or email.

AspectDetail
HeaderX-API-Key
Querydomain - 3–253 characters
Queryemail - business email address, max 254 characters

Response: BrandResponse - includes id, slug, name, brandColor, darkModeColor, verified, verifiedAt, variants (available SVG variant names), contrastTextColor, _css, and _notice.

Caching: Cache-Control: public, max-age=300

Background enrichment: When a match exists but SVG data is still being enriched, ingestion may continue in the background. The response is immediate; later requests may include additional variants or fields.

Errors:

  • 404 domain_not_found when no brand matches the resolved domain.
  • 422 validation_error when neither query parameter is supplied or both are supplied.
  • 422 email_not_brand_domain when email is malformed, uses a consumer provider, or cannot be resolved to a registrable brand domain.
curl "https://api.scrift.app/v1/brand?domain=stripe.com" \
-H "X-API-Key: YOUR_API_KEY"
curl "https://api.scrift.app/v1/brand?email=billing@stripe.com" \
-H "X-API-Key: YOUR_API_KEY"

Full schema: API reference.