Skip to main content
POST
/
v1
/
usage
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"
  }'

{
  "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
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.dune.com/llms.txt

Use this file to discover all available pages before exploring further.

Minimum required API key scope: Read

​
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 -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"
  }'

{
  "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
    }
  ]
}

Headers

​
X-Dune-Api-Key
string
required

API Key for the service

Query Parameters

​
api_key
string

API Key, alternative to using the HTTP header X-Dune-Api-Key

Body

application/json

Request payload with optional start_date and end_date

​
end_date
string

Optional field in YYYY-MM-DD format

​
start_date
string

Optional field in YYYY-MM-DD format

Response

OK

​
billing_periods
object[]
​
bytes_allowed
integer
​
bytes_used
integer
​
private_dashboards
integer
​
private_queries
integer