Get Usage

Retrieve customer usage data for billing periods

Description

Retrieves customer usage data including credits, queries, dashboards, and storage. Returns the current billing period when no timeframe is specified.

Pricing

This is a metadata endpoint and does not consume credits.

cURL

curl -X POST "https://api.dune.com/api/v1/usage" \
  -H "Content-Type: application/json" \
  -H "X-DUNE-API-KEY: YOUR_API_KEY" \
  -d '{
    "start_date": "2025-01-01",
    "end_date": "2025-02-01"
  }'

Example Response

{
  "private_queries": 100,
  "private_dashboards": 100,
  "bytes_used": 1000,
  "bytes_allowed": 10101,
  "billingPeriods": [
    {
      "start_date": "2025-01-01",
      "end_date": "2025-02-01",
      "credits_used": 100.10,
      "credits_included": 100000
    }
  ]
}