Overview

A project’s numbers over the last 7, 30 or 90 days.

Get the project overview

GET/projects/{project_id}/overview

The last 7, 30 or 90 UTC days next to the same span before them, the top campaigns, the contact count and whether the sender can send. is_sending_paused is true while the last 7 days ran past 5% bounces or 0.3% complaints (with at least 200 sent): campaigns and broadcasts wait until those days roll out of the week, and transactional email still sends.

Parameters

Name	In	Type	Notes
project_id	path	string	Required
days	query	number	Optional, default `30`

Request

curl "https://sendocado.com/api/v1/projects/$PROJECT_ID/overview?days=7" \
  -H "Authorization: Bearer $SENDOCADO_API_KEY"

Response 200

{
  "days": 7,
  "totals": {
    "sent_count": 1240,
    "delivered_count": 1221,
    "opened_count": 642,
    "clicked_count": 187,
    "replied_count": 41,
    "bounced_count": 6,
    "complained_count": 1,
    "unsubscribed_count": 9,
    "failed_count": 2
  },
  "previous_totals": {
    "sent_count": 1240,
    "delivered_count": 1221,
    "opened_count": 642,
    "clicked_count": 187,
    "replied_count": 41,
    "bounced_count": 6,
    "complained_count": 1,
    "unsubscribed_count": 9,
    "failed_count": 2
  },
  "rates": {
    "delivery_rate": 0.9847,
    "open_rate": 0.5177,
    "click_rate": 0.1508,
    "reply_rate": 0.0331,
    "bounce_rate": 0.0048,
    "complaint_rate": 0.0008,
    "unsubscribe_rate": 0.0073
  },
  "previous_rates": {
    "delivery_rate": 0.9847,
    "open_rate": 0.5177,
    "click_rate": 0.1508,
    "reply_rate": 0.0331,
    "bounce_rate": 0.0048,
    "complaint_rate": 0.0008,
    "unsubscribe_rate": 0.0073
  },
  "daily": [
    {
      "sent_count": 1240,
      "delivered_count": 1221,
      "opened_count": 642,
      "clicked_count": 187,
      "replied_count": 41,
      "bounced_count": 6,
      "complained_count": 1,
      "unsubscribed_count": 9,
      "failed_count": 2,
      "day": "2026-09-21"
    }
  ],
  "top_campaigns": [
    {
      "campaign_id": "h5dnsipzz5fk2z9ri19r0wyojfljooa5",
      "name": "Trial welcome",
      "status": "live",
      "sent_count": 1240,
      "open_rate": 0.5177,
      "click_rate": 0.1508,
      "reply_rate": 0.0331
    }
  ],
  "contact_count": 2418,
  "live_campaign_count": 3,
  "sender_status": "ready",
  "is_sending_paused": false
}

Errors

Status	Type	Example message
400	invalid_data	The query string is not valid: check each field against the reference.
401	unauthorized	Send a valid API key as "Authorization: Bearer sc_…", or sign in.
404	project_not_found	Project not found.
429	rate_limited	Too many requests. Try again in 12 seconds.