Fleet Analytics API

Query fleet-wide email forwarding volumes, time-series delivery trends, spam threat scores, tracker blockage telemetry, and vendor exposure graphs.

Quick Reference

GET /v1/analytics — Fleet Volume Overview

Scope: analytics:read · Rate Limit: 60/min · Idempotent: Yes

Returns aggregated forwarding counts, active alias ratios, domain breakdowns, category statistics, and highest-volume aliases across your fleet.

Query Parameters

Example Request

curl -X GET "https://api.aliasfleet.com/v1/analytics?timeRange=30d" \
  -H "Authorization: Bearer afp_4a8f9c1b2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e" \
  -H "Accept: application/json"

Response (200 OK)

{
  "overview": {
    "totalAliases": 42,
    "activeAliases": 38,
    "inactiveAliases": 4,
    "totalEmailsForwarded": 1284,
    "avgEmailsPerAlias": 30.57,
    "aliasGrowthRate": 0.9,
    "aliasesCreatedThisPeriod": 6
  },
  "categories": [
    {
      "category": "Customer Care",
      "count": 12,
      "emailsForwarded": 640,
      "activeCount": 12
    },
    {
      "category": "Billing",
      "count": 8,
      "emailsForwarded": 420,
      "activeCount": 8
    }
  ],
  "domains": [
    {
      "domain": "acme-corp.com",
      "count": 28,
      "emailsForwarded": 980,
      "activeCount": 26
    },
    {
      "domain": "af-mail.com",
      "count": 14,
      "emailsForwarded": 304,
      "activeCount": 12
    }
  ],
  "topAliases": [
    {
      "id": "al_6c5J5LMXd5E3Yq1Wx1zN",
      "local_part": "support",
      "full_alias": "support@acme-corp.com",
      "emails_forwarded": 312,
      "category": "Customer Care",
      "is_active": true,
      "last_email_at": "2026-09-04T12:00:00.000Z"
    }
  ],
  "timeRange": "30d",
  "fromDate": "2026-08-05T12:00:00.000Z",
  "toDate": "2026-09-04T12:00:00.000Z"
}

GET /v1/analytics/dashboard — Time-Series Dashboard Telemetry

Scope: analytics:read · Rate Limit: 60/min · Idempotent: Yes

Queries day-by-day delivery volumes (forwarded messages, rejected firewall blocks, anonymous replies), top sending domains, and hourly message distribution.

Query Parameters

Example Request

curl -X GET "https://api.aliasfleet.com/v1/analytics/dashboard?timeRange=7d" \
  -H "Authorization: Bearer afp_4a8f9c1b2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e" \
  -H "Accept: application/json"

Response (200 OK)

{
  "timeSeries": [
    {
      "date": "2026-09-03",
      "forwarded": 142,
      "blocked": 8,
      "replies": 14
    },
    {
      "date": "2026-09-04",
      "forwarded": 118,
      "blocked": 12,
      "replies": 9
    }
  ],
  "topDomains": [
    {
      "domain": "github.com",
      "count": 68
    },
    {
      "domain": "stripe.com",
      "count": 42
    }
  ],
  "totals": {
    "totalForwarded": 842,
    "totalBlocked": 56,
    "totalReplies": 78
  }
}

GET /v1/analytics/alias/:aliasId — Per-Alias Metrics

Scope: analytics:read · Rate Limit: 60/min · Idempotent: Yes

Inspects historical deliverability health, forwarding volumes, and reply counts for a specific alias.

Path Parameters

Example Request

curl -X GET "https://api.aliasfleet.com/v1/analytics/alias/al_6c5J5LMXd5E3Yq1Wx1zN?timeRange=30d" \
  -H "Authorization: Bearer afp_4a8f9c1b2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e" \
  -H "Accept: application/json"

Response (200 OK)

{
  "alias": {
    "id": "al_6c5J5LMXd5E3Yq1Wx1zN",
    "email": "support@acme-corp.com",
    "isActive": true,
    "createdAt": "2026-06-15T08:00:00.000Z"
  },
  "metrics": {
    "emailsForwarded": 312,
    "emailsBlocked": 14,
    "repliesSent": 45,
    "trackersBlocked": 98,
    "lastActivityAt": "2026-09-04T11:45:00.000Z"
  }
}

GET /v1/analytics/spam-analysis/:aliasId — Spam & Threat Telemetry

Scope: analytics:read · Rate Limit: 60/min · Idempotent: Yes

Returns cryptographic authentication rates, spam score percentiles, and spy tracker blockage metrics for an alias.

Path Parameters

Example Request

curl -X GET "https://api.aliasfleet.com/v1/analytics/spam-analysis/al_6c5J5LMXd5E3Yq1Wx1zN" \
  -H "Authorization: Bearer afp_4a8f9c1b2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e" \
  -H "Accept: application/json"

Response (200 OK)

{
  "spamDistribution": {
    "clean": 298,
    "suspicious": 11,
    "critical": 3
  },
  "trackerMetrics": {
    "totalEmailsWithTrackers": 184,
    "totalTrackersStripped": 412,
    "topTrackerDomains": [
      { "domain": "mandrillapp.com", "count": 142 },
      { "domain": "list-manage.com", "count": 98 }
    ]
  },
  "authenticationHealth": {
    "spfPassRate": 0.98,
    "dkimPassRate": 0.97,
    "dmarcPassRate": 0.96
  }
}

GET /v1/analytics/vendor-graph — Vendor Exposure Graph

Scope: analytics:read · Rate Limit: 30/min · Idempotent: Yes

Maps relationships between external sender organizations and receiving aliases, detecting cross-service contact sharing and data broker dissemination.

Example Request

curl -X GET "https://api.aliasfleet.com/v1/analytics/vendor-graph" \
  -H "Authorization: Bearer afp_4a8f9c1b2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e" \
  -H "Accept: application/json"

Response (200 OK)

{
  "nodes": [
    { "id": "vendor_stripe", "label": "stripe.com", "type": "sender" },
    { "id": "alias_billing", "label": "billing@acme-corp.com", "type": "alias" }
  ],
  "edges": [
    {
      "source": "vendor_stripe",
      "target": "alias_billing",
      "weight": 42,
      "lastInteraction": "2026-09-04T10:15:00.000Z"
    }
  ]
}

GET /v1/analytics/mta-origins — Inbound MTA Geographic Breakdown

Scope: analytics:read · Rate Limit: 60/min · Idempotent: Yes

Returns incoming message volume distributions mapped by country code and mail transfer agent origin networks.

Example Request

curl -X GET "https://api.aliasfleet.com/v1/analytics/mta-origins" \
  -H "Authorization: Bearer afp_4a8f9c1b2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e" \
  -H "Accept: application/json"

Response (200 OK)

{
  "origins": [
    { "countryCode": "US", "messageCount": 842, "percentage": 65.5 },
    { "countryCode": "DE", "messageCount": 240, "percentage": 18.7 },
    { "countryCode": "GB", "messageCount": 110, "percentage": 8.6 },
    { "countryCode": "Other", "messageCount": 92, "percentage": 7.2 }
  ]
}