Retrieve analytics

Counts per day or hour, delivery and bounce rates, delivery time, top tags and top bouncing domains.

GET/v1/analyticsAPI key

Returns the numbers behind the dashboard's Metrics page for the project. The buckets, totals and rates count live emails only; topTags counts every email in the range, test sends included.

Emails are grouped by when they were created (UTC), not when an event happened. So an email created on Monday and bounced on Tuesday counts as bounced on Monday. The status counts use each email's current status: an email that was deferred and later delivered counts only as delivered.

Query parameters

range'7d' | '30d' | '90d'querydefault: 7d

How far back to look, counted in whole UTC days including today.

interval'day' | 'hour'querydefault: day

The bucket size. With day, every day in the range has a bucket, even with no emails. With hour, only hours that have emails are listed.

Response

rangestring

The range used.

interval'day' | 'hour'

The interval used.

bucketsBucket[]

In time order. Each has a bucket label (2026-09-25 for days, 2026-09-25T14 for hours) and one count per metric.

Show metrics

sentnumber

Emails handed to Cloudflare.

deliverednumber

Emails whose status is delivered. deferred, bounced, complained, rejected and failed count the same way.

openednumber

Emails opened at least once (open tracking only).

clickednumber

Emails with at least one tracked click.

totalsobject

The same nine metrics summed over the range.

deliveryRatenumber | null

delivered / sent, rounded to four decimals, for example 0.9812. null when nothing was sent. bounceRate and complaintRate work the same way.

p50DeliveryMsnumber | null

The median time Cloudflare took to deliver to a recipient, in milliseconds. p95DeliveryMs is the 95th percentile. null when there is no delivery data.

topTagsArray<{ tag, count }>

The 10 most used tags as key:value, with how many emails carried each.

topBouncedDomainsArray<{ domain, count }>

The 10 recipient domains with the most bounced recipients.

Errors

Status	Code	When
400	`invalid_query`	`range` or `interval` has a value not listed above.

Request

import { Flaresend } from '@flaresend/client';

const flaresend = new Flaresend({
  apiKey: process.env.FLARESEND_API_KEY!,
  baseUrl: 'https://mailer.example.com',
});

const stats = await flaresend.analytics.get({ range: '30d', interval: 'day' });

Response

{
  "range": "7d",
  "interval": "day",
  "buckets": [
    {
      "bucket": "2026-09-20",
      "sent": 412,
      "delivered": 405,
      "deferred": 0,
      "bounced": 5,
      "complained": 0,
      "rejected": 1,
      "failed": 1,
      "opened": 0,
      "clicked": 0
    }
  ],
  "totals": {
    "sent": 2890,
    "delivered": 2841,
    "deferred": 2,
    "bounced": 36,
    "complained": 1,
    "rejected": 6,
    "failed": 4,
    "opened": 0,
    "clicked": 0
  },
  "deliveryRate": 0.983,
  "bounceRate": 0.0125,
  "complaintRate": 0.0003,
  "p50DeliveryMs": 1840,
  "p95DeliveryMs": 6120,
  "topTags": [
    { "tag": "kind:password-reset", "count": 1203 },
    { "tag": "kind:welcome", "count": 988 }
  ],
  "topBouncedDomains": [
    { "domain": "example.net", "count": 12 }
  ]
}

Query parametersCopy Anchor Link

ResponseCopy Anchor Link

ErrorsCopy Anchor Link

Query parameters

Response

Errors