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 usage
Returns API credit consumption for the current billing period for the workspace resolved from the API key.
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 September 3, 2026
Was this page helpful?