Get workspace usage
curl --request GET \
--url https://api.range.org/v1/workspace/usage \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.range.org/v1/workspace/usage"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.range.org/v1/workspace/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.range.org/v1/workspace/usage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.range.org/v1/workspace/usage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.range.org/v1/workspace/usage")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.range.org/v1/workspace/usage")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"credits_used": 1204,
"credits_limit": 1000000,
"credits_remaining": 998796,
"reset_date": "2026-08-01T00:00:00.000Z",
"by_family": [
{
"family": "risk",
"credits": 980,
"requests": 950
}
],
"by_route": [
{
"method": "GET",
"route": "/v1/risk/address",
"credits": 800,
"requests": 800
}
]
}Workspace Usage
Get workspace credit usage
Read billing-period API credit totals and usage breakdowns for the authenticated workspace.
GET
/
v1
/
workspace
/
usage
Get workspace usage
curl --request GET \
--url https://api.range.org/v1/workspace/usage \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.range.org/v1/workspace/usage"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.range.org/v1/workspace/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.range.org/v1/workspace/usage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.range.org/v1/workspace/usage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.range.org/v1/workspace/usage")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.range.org/v1/workspace/usage")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"credits_used": 1204,
"credits_limit": 1000000,
"credits_remaining": 998796,
"reset_date": "2026-08-01T00:00:00.000Z",
"by_family": [
{
"family": "risk",
"credits": 980,
"requests": 950
}
],
"by_route": [
{
"method": "GET",
"route": "/v1/risk/address",
"credits": 800,
"requests": 800
}
]
}Authorizations
AuthorizationAuthorization
Authorization method required to allow user to access the api endpoints.
Response
200 - application/json
API credits consumed in the current billing period
Example:
1204
API credit limit for the current billing period
Example:
1000000
Credits left before requests are rate limited
Example:
998796
When the credit counter resets — start of the next billing period (UTC, ISO 8601)
Example:
"2026-08-01T00:00:00.000Z"
Credits and request counts grouped by operation family
Show child attributes
Show child attributes
Credits and request counts grouped by exact route
Show child attributes
Show child attributes
Last modified on November 10, 2026
Was this page helpful?