Analytics

curl "https://api.mail.gorillaa.one/v1/stats?start_date=2026-02-01T00:00:00Z&end_date=2026-02-09T00:00:00Z" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "period": {
      "from": "2026-02-01T00:00:00Z",
      "to": "2026-02-09T00:00:00Z"
    },
    "stats": {
      "total": 15420,
      "queued": 0,
      "sending": 0,
      "sent": 15210,
      "delivered": 15105,
      "bounced": 210,
      "failed": 5,
      "opens": 8750,
      "clicks": 2340,
      "deliveryRate": 0.9796,
      "openRate": 0.5792,
      "clickRate": 0.1549,
      "bounceRate": 0.0136
    }
  }
}

curl "https://api.mail.gorillaa.one/v1/stats/domains?start_date=2026-02-01T00:00:00Z&end_date=2026-02-09T00:00:00Z" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "period": {
      "from": "2026-02-01T00:00:00Z",
      "to": "2026-02-09T00:00:00Z"
    },
    "domains": [
      {
        "domain": "yourdomain.com",
        "total": 12000,
        "sent": 11950,
        "delivered": 11800,
        "bounced": 150,
        "opens": 7200,
        "clicks": 1900,
        "deliveryRate": 0.9833,
        "bounceRate": 0.0125
      },
      {
        "domain": "notifications.yourdomain.com",
        "total": 3420,
        "sent": 3400,
        "delivered": 3305,
        "bounced": 60,
        "opens": 1550,
        "clicks": 440,
        "deliveryRate": 0.9664,
        "bounceRate": 0.0175
      }
    ]
  }
}

curl "https://api.mail.gorillaa.one/v1/stats/hourly?start_date=2026-02-08T00:00:00Z&end_date=2026-02-09T00:00:00Z" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "period": {
      "from": "2026-02-08T00:00:00Z",
      "to": "2026-02-09T00:00:00Z"
    },
    "hourly": [
      {
        "timestamp": "2026-02-08T00:00:00Z",
        "sent": 120,
        "delivered": 118,
        "bounced": 2,
        "opens": 45,
        "clicks": 12
      },
      {
        "timestamp": "2026-02-08T01:00:00Z",
        "sent": 95,
        "delivered": 94,
        "bounced": 1,
        "opens": 38,
        "clicks": 8
      }
    ]
  }
}

curl "https://api.mail.gorillaa.one/v1/stats/reputation" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "organizationId": "org_abc123",
    "metrics": {
      "overallScore": 92,
      "bounceRate": 0.012,
      "complaintRate": 0.0002,
      "deliveryRate": 0.985,
      "healthStatus": "excellent"
    },
    "recommendations": [
      "Your delivery metrics are excellent. Keep up the good work!"
    ]
  }
}