Overview

Returns aggregate API usage for your org over a date range — request count, records returned, bytes served, and dollar cost — plus a per-day breakdown. Defaults to the last 30 days.

Authenticated by API key; this endpoint is not billed and does not consume credits.

When to use

• Building an internal cost-tracking dashboard.
• Reconciling AskEdgar charges against your own usage logs.
• Spotting traffic spikes or unexpected zero-day gaps.

Key parameters

• start_date (optional) — YYYY-MM-DD. Defaults to 30 days ago.
• end_date (optional) — YYYY-MM-DD. Defaults to today.

Response highlights

• Top-level totals: total_requests, total_records, total_bytes, total_cost_dollars.
• items[] — one row per usage_date with the same four metrics scoped to that day. Days with zero traffic are omitted.

Notes

• For request-by-request detail rather than daily aggregates, use Usage Activity.