Stats: Category Stats

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/sendgrid/main/json-schema/sendgrid-category-stats-schema.json",
  "title": "Stats: Category Stats",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/sendgrid-categories-api-openapi.yml#/components/schemas/CategoryStats",
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "The date the statistics were gathered."
    },
    "stats": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "metrics": {
            "type": "object",
            "properties": {
              "blocks": {
                "type": "integer",
                "description": "The number of emails that were not allowed to be delivered by ISPs."
              },
              "bounce_drops": {
                "type": "integer",
                "description": "The number of emails that were dropped because of a bounce."
              },
              "bounces": {
                "type": "integer",
                "description": "The number of emails that bounced instead of being delivered."
              },
              "clicks": {
                "type": "integer",
                "description": "The number of links that were clicked."
              },
              "deferred": {
                "type": "integer",
                "description": "The number of emails that temporarily could not be delivered."
              },
              "delivered": {
                "type": "integer",
                "description": "The number of emails SendGrid was able to confirm were actually delivered to a recipient."
              },
              "invalid_emails": {
                "type": "integer",
                "description": "The number of recipients who had malformed email addresses or whose mail provider reported the address as invalid."
              },
              "opens": {
                "type": "integer",
                "description": "The total number of times your emails were opened by recipients."
              },
              "processed": {
                "type": "integer",
                "description": "Requests from your website, application, or mail client via SMTP Relay or the API that SendGrid processed."
              },
              "requests": {
                "type": "integer",
                "description": "The number of emails that were requested to be delivered."
              },
              "spam_report_drops": {
                "type": "integer",
                "description": "The number of emails that were dropped due to a recipient previously marking your emails as spam."
              },
              "spam_reports": {
                "type": "integer",
                "description": "The number of recipients who marked your email as spam."
              },
              "unique_clicks": {
                "type": "integer",
                "description": "The number of unique recipients who clicked links in your emails."
              },
              "unique_opens": {
                "type": "integer",
                "description": "The number of unique recipients who opened your emails."
              },
              "unsubscribe_drops": {
                "type": "integer",
                "description": "The number of emails dropped due to a recipient unsubscribing from your emails."
              },
              "unsubscribes": {
                "type": "integer",
                "description": "The number of recipients who unsubscribed from your emails."
              }
            },
            "required": [
              "blocks",
              "bounce_drops",
              "bounces",
              "clicks",
              "deferred",
              "delivered",
              "invalid_emails",
              "opens",
              "processed",
              "requests",
              "spam_report_drops",
              "spam_reports",
              "unique_clicks",
              "unique_opens",
              "unsubscribe_drops",
              "unsubscribes"
            ]
          },
          "name": {
            "type": "string",
            "description": "The name of the category."
          },
          "type": {
            "type": "string",
            "description": "How you are segmenting your statistics."
          }
        },
        "required": [
          "type"
        ]
      }
    }
  },
  "required": [
    "date"
  ]
}