This method is available only to Enterprise accounts. See the Observability overview for more information.

Query Parameters

from

string

ISO 8601 start time. Required together with to when last is omitted.

to

string

ISO 8601 end time. Required together with from when last is omitted.

last

string

Relative time window instead of from and to; for example, 1h for the last hour.

Returns

data

object | null

Response data. Null when the request fails.

from

string

Effective start of the returned time range, in ISO 8601 format.

to

string

Effective end of the returned time range, in ISO 8601 format.

totals

object

Aggregate totals for the selected time range.

credits

integer

Total API credits consumed.

error

string | null

Error message on failure; null on success.

Request

1
curl --get "https://api.quicknode.com/v0/usage/credits/summary" \
2
  --header "accept: application/json" \
3
  --header "x-api-key: ${QN_API_KEY}" \
4
  --data-urlencode 'from=2026-10-19T19:29:00Z' \
5
  --data-urlencode 'to=2026-10-20T19:29:00Z'
6

1
curl --get "https://api.quicknode.com/v0/usage/credits/summary" \
2
  --header "accept: application/json" \
3
  --header "x-api-key: ${QN_API_KEY}" \
4
  --data-urlencode 'from=2026-10-19T19:29:00Z' \
5
  --data-urlencode 'to=2026-10-20T19:29:00Z'
6

1
const url = new URL(`https://api.quicknode.com/v0/usage/credits/summary`);
2
url.searchParams.append("from", "2026-10-19T19:29:00Z");
3
url.searchParams.append("to", "2026-10-20T19:29:00Z");
4

5
fetch(url, {
6
  headers: { "accept": "application/json", "x-api-key": process.env.QN_API_KEY },
7
})
8
  .then(async (response) => {
9
    const body = await response.text();
10
    if (!response.ok) throw new Error(`HTTP ${response.status}: ${body}`);
11
    console.log(body);
12
  })
13
  .catch((error) => { console.error(error); process.exitCode = 1; });
14

1
const url = new URL(`https://api.quicknode.com/v0/usage/credits/summary`);
2
url.searchParams.append("from", "2026-10-19T19:29:00Z");
3
url.searchParams.append("to", "2026-10-20T19:29:00Z");
4

5
fetch(url, {
6
  headers: { "accept": "application/json", "x-api-key": process.env.QN_API_KEY },
7
})
8
  .then(async (response) => {
9
    const body = await response.text();
10
    if (!response.ok) throw new Error(`HTTP ${response.status}: ${body}`);
11
    console.log(body);
12
  })
13
  .catch((error) => { console.error(error); process.exitCode = 1; });
14

1
import os
2
from urllib.parse import quote
3
import requests
4

5
url = f"https://api.quicknode.com/v0/usage/credits/summary"
6
params = {'from': '2026-10-19T19:29:00Z', 'to': '2026-10-20T19:29:00Z'}
7
response = requests.get(
8
    url, params=params,
9
    headers={"accept": "application/json", "x-api-key": os.environ["QN_API_KEY"]},
10
    timeout=60,
11
)
12
response.raise_for_status()
13
print(response.text)
14

1
import os
2
from urllib.parse import quote
3
import requests
4

5
url = f"https://api.quicknode.com/v0/usage/credits/summary"
6
params = {'from': '2026-10-19T19:29:00Z', 'to': '2026-10-20T19:29:00Z'}
7
response = requests.get(
8
    url, params=params,
9
    headers={"accept": "application/json", "x-api-key": os.environ["QN_API_KEY"]},
10
    timeout=60,
11
)
12
response.raise_for_status()
13
print(response.text)
14

1
require "uri"
2
require "net/http"
3

4
url = URI("https://api.quicknode.com/v0/usage/credits/summary")
5
url.query = URI.encode_www_form({"from" => "2026-10-19T19:29:00Z", "to" => "2026-10-20T19:29:00Z"})
6
request = Net::HTTP::Get.new(url)
7
request["accept"] = "application/json"
8
request["x-api-key"] = ENV.fetch("QN_API_KEY")
9
response = Net::HTTP.start(url.hostname, url.port, use_ssl: true) { |http| http.request(request) }
10
raise "HTTP #{response.code}: #{response.body}" unless response.is_a?(Net::HTTPSuccess)
11
puts response.body
12

1
require "uri"
2
require "net/http"
3

4
url = URI("https://api.quicknode.com/v0/usage/credits/summary")
5
url.query = URI.encode_www_form({"from" => "2026-10-19T19:29:00Z", "to" => "2026-10-20T19:29:00Z"})
6
request = Net::HTTP::Get.new(url)
7
request["accept"] = "application/json"
8
request["x-api-key"] = ENV.fetch("QN_API_KEY")
9
response = Net::HTTP.start(url.hostname, url.port, use_ssl: true) { |http| http.request(request) }
10
raise "HTTP #{response.code}: #{response.body}" unless response.is_a?(Net::HTTPSuccess)
11
puts response.body
12

Response

1
{
2
  "data": {
3
    "from": "2026-10-19T19:29:00.000000Z",
4
    "to": "2026-10-20T20:00:00.000000Z",
5
    "totals": {
6
      "credits": 1578989578
7
    }
8
  },
9
  "error": null
10
}

1
{
2
  "data": {
3
    "from": "2026-10-19T19:29:00.000000Z",
4
    "to": "2026-10-20T20:00:00.000000Z",
5
    "totals": {
6
      "credits": 1578989578
7
    }
8
  },
9
  "error": null
10
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free