BIMI Check
free/v1/security/bimiChecks BIMI (Brand Indicators for Message Identification) configuration that enables verified brand logos to appear next to emails in supporting clients including Gmail, Apple Mail (iOS 16+/macOS Ventura+), Yahoo Mail, and Fastmail. Validates the BIMI DNS record, SVG Tiny PS logo URL accessibility and format requirements, Verified Mark Certificate (VMC) or Common Mark Certificate (CMC) reference, and DMARC enforcement prerequisite (p=quarantine or p=reject required).
What It Does
Queries the default._bimi.<domain> TXT record for the BIMI record, validates the v=BIMI1 syntax, checks the SVG Tiny PS logo URL (l= tag) for accessibility, correct content type (image/svg+xml), HTTPS requirement, and file size limit (32KB max). Verifies the VMC/CMC certificate URL (a= tag) if present. Checks the domain's DMARC policy as a prerequisite — BIMI requires p=quarantine or p=reject to function. Reports which email clients will display the logo based on VMC/CMC status.
Why It's Useful
BIMI increases email engagement by displaying your verified brand logo directly in the inbox — studies show 10-20% higher open rates with brand indicators. It also provides anti-phishing benefits since only properly authenticated domains with enforced DMARC can use BIMI. Gmail requires a VMC (Verified Mark Certificate) or CMC (Common Mark Certificate) from DigiCert or Entrust for logo display. CMC is a lower-cost alternative that does not require a registered trademark. Apple Mail supports BIMI via Apple Business Connect, while Yahoo Mail and Fastmail display logos without requiring VMC.
Use Cases
Brand Email Enhancement
Verify BIMI is properly configured to display company logo in Gmail, Apple Mail, Yahoo Mail, and other supporting email clients.
Increase email open rates and brand recognition with verified logo visibility in inbox.
BIMI Implementation Validation
After uploading SVG Tiny PS logo and publishing BIMI DNS record, verify configuration meets all requirements including DMARC enforcement.
Confirm BIMI setup is complete and correct before announcing to stakeholders.
Competitive Brand Analysis
Check if competitors have implemented BIMI and whether they have VMC/CMC certificates for Gmail display.
Benchmark brand email experience and identify competitive advantages.
DMARC Readiness Check
Before investing in BIMI setup (SVG logo, VMC/CMC certificate), verify that DMARC enforcement is at p=quarantine or p=reject — the mandatory prerequisite.
Avoid wasted investment on BIMI configuration that won't display due to insufficient DMARC enforcement.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Required | The domain to check BIMI configuration forExample: cnn.com |
Response Fields
| Field | Type | Description |
|---|---|---|
domain | string | The queried domain |
has_bimi | boolean | Whether a BIMI record exists |
record | string | Raw BIMI record value |
version | string | BIMI version (v=BIMI1) |
logo_url | string | SVG Tiny PS logo URL from l= tag |
vmc_url | string | VMC/CMC certificate URL from a= tag (required for Gmail) |
logo_valid | boolean | Whether the logo URL is accessible, returns valid SVG content type, and meets size requirements |
has_vmc | boolean | Whether a VMC or CMC certificate is referenced |
dmarc_enforced | boolean | Whether DMARC is set to quarantine or reject (required for BIMI) |
issues | array | Configuration issues and warnings |
recommendations | array | Setup and improvement recommendations |
Code Examples
curl "https://api.edgedns.dev/v1/security/bimi" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d "domain=cnn.com"const response = await fetch(
'https://api.edgedns.dev/v1/security/bimi?domain=cnn.com',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);import requests
response = requests.get(
'https://api.edgedns.dev/v1/security/bimi',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={
'domain': 'cnn.com'
}
)
data = response.json()
print(data)Read the full BIMI Check guide
Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.
Read the guide →Related Endpoints
External References
Learn more about the standards and protocols behind this endpoint.