Units consumed in the current billing period

GET/v1/meta/usage

Cost: Free
Operation: metaUsage
Auth: X-API-Key

Free — 0 units. Plan, units used, units remaining, period end.

Request#

GET /v1/meta/usage

curl -X GET https://api.grahvani.in/v1/meta/usage \
  -H "X-API-Key: $GRAHVANI_KEY"

import os, requests

URL = "https://api.grahvani.in/v1/meta/usage"
HEADERS = {"X-API-Key": os.environ["GRAHVANI_KEY"]}

r = requests.get(URL, headers=HEADERS, timeout=60)
r.raise_for_status()
data = r.json()

print(data["meta"]["units"], "units")

const res = await fetch("https://api.grahvani.in/v1/meta/usage", {
  method: "GET",
  headers: {
    "X-API-Key": process.env.GRAHVANI_KEY,
  },
});

if (!res.ok) throw new Error((await res.json()).error.message);
const { data, meta } = await res.json();
console.log(meta.units, "units");

<?php
$ch = curl_init("https://api.grahvani.in/v1/meta/usage");
$headers = ["X-API-Key: " . getenv("GRAHVANI_KEY")];
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
echo $data["meta"]["units"] . " units";

Response#

A real response from the production API, abbreviated where an array was long. Every success carries the same three keys — data, meta and, where we have something citable, provenance.

200 OK

{
  "data": {
    "plan": "developer",
    "units_used": 1284,
    "units_included": 50000,
    "units_remaining": 48716,
    "rate_limit_per_minute": 60,
    "period_end": "2026-09-01T00:00:00Z"
  },
  "meta": {
    "request_id": "req_01JQ8ZK3M4N5P6Q7R8S9T",
    "endpoint": "meta.usage",
    "units": 0,
    "computed_at": "2026-08-06T07:24:09.647Z"
  }
}

Introduction API reference Errors OpenAPI spec llms.txt

Grahvani API — a product of AstroCorp Techlab Pvt Ltd · GSTIN 36AAMCC3512G1ZU

Base URL https://api.grahvani.in