Analytics & Reports API

Analytics & Reports API These read-only endpoints let you pull your account's activity into your own dashboards and reports: message-event counts, credit consumption, and AI spend. There are three endpoints: Summary — message-volume counters (sent, delivered, read, replied, booked, contacts created, credits). Credits — a detailed, paginated ledger of credit usage with totals and breakdowns. AI cost — a per-day rollup of AI spend. All paths below are relative to the API base URL: https://api.relaytiv.com/v1 Every request must be authenticated. See Authentication for the four accepted methods. The examples here use the X-API-Key header (and one query-parameter form for cURL). Date range All three endpoints accept the same optional date filters: Parameter Description from Start of the range, YYYY-MM-DD , inclusive. Defaults to 30 days ago. to End of the range, YYYY-MM-DD , inclusive. Defaults to today. Dates are interpreted in UTC. The range defaults to the last 30 days and is capped at 366 days — a wider range returns 400 . from must not be after to . The `truncated` flag The Summary and Credits endpoints cap how many records a single request scans. If your range is busy enough to hit that cap, the response includes "truncated": true . When you see it, the numbers are based on a partial scan — narrow your date range (or page through with a smaller window) to get complete figures. 📝 Note: Cost and token figures are only included for AI calls billed to your own provider API