Reports · Ready Docs

#Reports

Daily numbers for one account: texts sent, segments, delivered, replies and what was charged. An agency can pull them for each client account it manages.

Details

For a client, call with your own key and add X-Sub-Account-Id: <client id> (Acting as a client). List client ids with GET /v1/sub-accounts. For a nightly job, ask for yesterday in each client's timezone.

#Daily report

GET/v1/reports/daily

One row per calendar day in the account's timezone (Pacific if none is set), oldest first. Days with no activity are included with zeros.

Auth API key with reports access (plus team management to use X-Sub-Account-Id)
Cost Free

Query parameters

fromstringOptional: First day, YYYY-MM-DD. Send with to.
tostringOptional: Last day, YYYY-MM-DD, included. Today at the latest.
daysintegerOptionalDefault 30Max 93: The last N days, today included. Use days or from and to, not both. A range is at most 93 days.

Returns

account_idinteger: The account the report is for.
timezonestring: The timezone the days are counted in. Changing the account's timezone regroups past days too.
from, to, generated_atstring: The days covered, and when the report was read.
data[]object[]: date; complete (false for today); sms_sent (texts handed to the carrier, MMS not included); sms_segments_sent; sms_delivered (of those, delivered so far); replies (inbound messages, opt-outs not included); positive_replies; sms_cost_usd and total_usage_cost_usd (decimal strings, before refunds).
limitationsstring[]: What the costs leave out, in plain words. Number and registration fees are never in either cost.

Delivery receipts and reply tags can still change a past day, so fetch a day again if you need it final.

Errors

HTTP	Code	When
400	`invalid_report_range`	An unknown parameter, a bad or future date, `from` without `to`, `days` with dates, or more than 93 days.
403	`permission_denied`	The key lacks reports access, or team management when `X-Sub-Account-Id` is sent.
403	`report_scope_forbidden`	The key's user only sees contacts assigned to them.
429	`report_busy`	Two reports for your account are already running. Wait for `Retry-After` seconds.
503	`report_unavailable`	The report could not be read. Retry; do not record zeros.

GET /v1/reports/daily

curl "https://api.tryready.com/v1/reports/daily?from=2026-10-08&to=2026-10-08" \
  -H "X-API-Key: $READY_API_KEY" \
  -H "X-Sub-Account-Id: 4812"

const res = await fetch('https://api.tryready.com/v1/reports/daily?from=2026-10-08&to=2026-10-08', {
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
    'X-Sub-Account-Id': '4812',
  },
});
const json = await res.json();
if (!res.ok || json.success === false) {
  throw new Error(`${res.status} ${json.error_code || json.code}: ${json.error}`);
}

import os, requests

r = requests.get(
    "https://api.tryready.com/v1/reports/daily",
    headers={"X-API-Key": os.environ["READY_API_KEY"], "X-Sub-Account-Id": "4812"},
    params={
        "from": "2026-10-08",
        "to": "2026-10-08"
    },
    timeout=30,
)
data = r.json()
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code")}: {data.get("error")}')

Response

{
  "success": true,
  "account_id": 4812,
  "timezone": "America/Los_Angeles",
  "from": "2026-10-08",
  "to": "2026-10-08",
  "generated_at": "2026-10-09T15:02:11.481Z",
  "currency": "USD",
  "cost_scope": "attributed_usage_only",
  "cost_basis": "gross_usage_before_refunds",
  "limitations": ["Number subscriptions and registration fees are excluded from usage cost."],
  "data": [
    {
      "date": "2026-10-08",
      "complete": true,
      "sms_sent": 1240,
      "sms_segments_sent": 1381,
      "sms_delivered": 1197,
      "replies": 86,
      "positive_replies": 31,
      "sms_cost_usd": "33.8345",
      "total_usage_cost_usd": "35.1045"
    }
  ]
}