Usage
Get usage
Plan, period, and what is used and left. Works even when the workspace is out of ops.
GET
/
v2
/
usage
Get usage
curl --request GET \
--url https://api.opennous.cloud/v2/usage \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.opennous.cloud/v2/usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.opennous.cloud/v2/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.opennous.cloud/v2/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 => [
"Authorization: Bearer <token>"
],
]);
$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.opennous.cloud/v2/usage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.opennous.cloud/v2/usage")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.opennous.cloud/v2/usage")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"plan": {
"id": "growth",
"name": "Growth"
},
"self_hosted": false,
"subscription_status": "active",
"period": {
"start": "2026-09-01T00:00:00Z",
"end": "2026-10-01T00:00:00Z"
},
"ops": {
"used": 1840,
"limit": 10000,
"left": 8160
},
"credits": {
"used": 188,
"limit": 500,
"left": 312,
"percent_used": 38,
"state": "ok",
"unlimited": false
},
"enrichments": {
"used": 0,
"limit": 0,
"left": 0
},
"active_accounts": {
"used": 212,
"limit": 1000,
"left": 788,
"state": "ok"
}
}
Your plan, the current period, and what is used and left. Usage calls are never blocked by the ops limit, so you can always see where you stand.
Authorizations
bearerAuthapiKeyHeader
Workspace API key. Create one in Settings → API keys.
⌘I
Get usage
curl --request GET \
--url https://api.opennous.cloud/v2/usage \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.opennous.cloud/v2/usage"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.opennous.cloud/v2/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.opennous.cloud/v2/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 => [
"Authorization: Bearer <token>"
],
]);
$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.opennous.cloud/v2/usage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.opennous.cloud/v2/usage")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.opennous.cloud/v2/usage")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"plan": {
"id": "growth",
"name": "Growth"
},
"self_hosted": false,
"subscription_status": "active",
"period": {
"start": "2026-09-01T00:00:00Z",
"end": "2026-10-01T00:00:00Z"
},
"ops": {
"used": 1840,
"limit": 10000,
"left": 8160
},
"credits": {
"used": 188,
"limit": 500,
"left": 312,
"percent_used": 38,
"state": "ok",
"unlimited": false
},
"enrichments": {
"used": 0,
"limit": 0,
"left": 0
},
"active_accounts": {
"used": 212,
"limit": 1000,
"left": 788,
"state": "ok"
}
}