Usage
Current balance for the key. Authenticated but never metered: checking your balance is free.
Endpoint
Never meteredGET https://conureapi.com/v1/usage
Request
| Field | Type | Required | Description |
|---|---|---|---|
| This endpoint takes no request body. | |||
Response
{
"period": "2026-08",
"free_used": 412,
"free_limit": 1000,
"free_remaining": 588,
"paid_remaining": 0,
"total_remaining": 588
}Code examples
curl -X GET https://conureapi.com/v1/usage \ -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://conureapi.com/v1/usage", {
method: "GET",
headers: {
Authorization: "Bearer YOUR_API_KEY",
},
signal: AbortSignal.timeout(5000),
});
if (!response.ok) throw new Error("conure: " + response.status);
console.log(await response.json());
import requests
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get(
"https://conureapi.com/v1/usage",
headers=HEADERS,
timeout=5,
)
response.raise_for_status()
print(response.json())
package main
import (
"encoding/json"
"fmt"
"net/http"
"time"
)
func main() {
client := &http.Client{Timeout: 5 * time.Second}
req, _ := http.NewRequest("GET", "https://conureapi.com/v1/usage", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
resp, err := client.Do(req)
if err != nil {
fmt.Println("conure unavailable, allowing request:", err)
return
}
defer resp.Body.Close()
var verdict map[string]any
json.NewDecoder(resp.Body).Decode(&verdict)
fmt.Println(verdict)
}
$curl = curl_init("https://conureapi.com/v1/usage");
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 5,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer YOUR_API_KEY",
],
]);
$body = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
curl_close($curl);
$verdict = $status === 200 ? json_decode($body, true) : null;
var_dump($verdict);
require "net/http"
require "json"
uri = URI("https://conureapi.com/v1/usage")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
response = Net::HTTP.start(uri.hostname, uri.port,
use_ssl: uri.scheme == "https",
open_timeout: 5, read_timeout: 5) do |http|
http.request(request)
end
puts JSON.parse(response.body)
Try it
Runs against the live API from your browser. Your key stays in this tab and is sent nowhere but this endpoint.
Pricing
Free. This endpoint is authenticated but never metered. Full pricing is on your billing page.
Rate limits
120 requests per minute per API key. Exceeding it returns
429 with a Retry-After header, and costs no credits.
Rate limiting fails open: if the limiter itself is unavailable your request is
served rather than rejected.
Need a higher limit? See errors and limits for how the limiter behaves under load.