Skip to main content
GET
/
messages
/
stats
Get Message Stats
curl --request GET \
  --url https://api.politicalcomms.com/v1/messages/stats \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "totals": {
      "sent": 1452300,
      "delivered": 1438700,
      "undeliverable": 13600,
      "replies": 124400,
      "opt_outs": 8650
    },
    "daily": [
      {
        "date": "2026-01-01",
        "sent": 48400,
        "delivered": 47950,
        "undeliverable": 450,
        "replies": 4150,
        "opt_outs": 290
      },
      {
        "date": "2026-01-02",
        "sent": 51200,
        "delivered": 50720,
        "undeliverable": 480,
        "replies": 4280,
        "opt_outs": 310
      }
    ]
  }
}

Authorizations

​
X-API-Key
string
header
required

Authenticate every request by passing your API key in the X-API-Key header. Keys are scoped to your organization hierarchy.

Query Parameters

​
startDate
string<date>
required

Start date in YYYY-MM-DD format

Example:

"2026-01-01"

​
endDate
string<date>
required

End date in YYYY-MM-DD format

Example:

"2026-01-31"

​
organizationId
string

Filter to a specific descendant organization

​
brandId
string

Filter to a specific brand

​
campaignId
string

Filter to a specific campaign

Response

Successful response