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.
| Aspect | Detail |
|---|---|
| Header | X-API-Key |
| Query | domain - 3–253 characters |
| Query | email - 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_foundwhen no brand matches the resolved domain.422 validation_errorwhen neither query parameter is supplied or both are supplied.422 email_not_brand_domainwhenemailis 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.