Skip to main content

BIMI Check

free
GET/v1/security/bimi

Checks 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

Marketing Manager

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.

Email Administrator

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.

Brand Manager

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.

Security Engineer

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

NameTypeRequiredDescription
domainstringRequiredThe domain to check BIMI configuration forExample: cnn.com

Response Fields

FieldTypeDescription
domainstringThe queried domain
has_bimibooleanWhether a BIMI record exists
recordstringRaw BIMI record value
versionstringBIMI version (v=BIMI1)
logo_urlstringSVG Tiny PS logo URL from l= tag
vmc_urlstringVMC/CMC certificate URL from a= tag (required for Gmail)
logo_validbooleanWhether the logo URL is accessible, returns valid SVG content type, and meets size requirements
has_vmcbooleanWhether a VMC or CMC certificate is referenced
dmarc_enforcedbooleanWhether DMARC is set to quarantine or reject (required for BIMI)
issuesarrayConfiguration issues and warnings
recommendationsarraySetup and improvement recommendations

Code Examples

cURL
curl "https://api.edgedns.dev/v1/security/bimi" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "domain=cnn.com"
JavaScript
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);
Python
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.

Try This Endpoint

Test the BIMI Check endpoint live in the playground.