/ai/token/usage_daily


GET https://api.sitehost.nz/1.5/ai/token/usage_daily.json

Returns a token's usage for each day of one NZ calendar month. Only days with usage are included. Billed figures count successful requests only, with failed requests counted separately in failed_requests. Costs are in NZD (excl. GST), and complete is false when cost data for that day is not yet final. Future months cannot be requested.

Query Parameters

ParameterTypeRequiredDescription
client_idintegerYesThe ID for the client.Example: 1
key_idstringYesThe ID of the token.Example: 3f6c2a9e-8b14-4d7a-9c5e-1a2b3c4d5e6f
monthintegerYesThe month to return, from 1 to 12.Example: 9
yearintegerYesThe year to return, from 2026 onwards.Example: 2026

Code Samples

JavaScript PHP Rails Python
var xmlHttp = new XMLHttpRequest();
xmlHttp.open("GET", "https://api.sitehost.nz/1.5/ai/token/usage_daily.json?apikey=your_key_here&client_id=1&key_id=3f6c2a9e-8b14-4d7a-9c5e-1a2b3c4d5e6f&month=9&year=2026", false);

xmlHttp.send();

var response = xmlHttp.responseText;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.sitehost.nz/1.5/ai/token/usage_daily.json?apikey=your_key_here&client_id=1&key_id=3f6c2a9e-8b14-4d7a-9c5e-1a2b3c4d5e6f&month=9&year=2026");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
require 'net/http'
require 'uri'

uri = URI.parse("https://api.sitehost.nz/1.5/ai/token/usage_daily.json?apikey=your_key_here&client_id=1&key_id=3f6c2a9e-8b14-4d7a-9c5e-1a2b3c4d5e6f&month=9&year=2026")
http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Get.new(uri.request_uri)

response = http.request(request)
import requests

uri = 'https://api.sitehost.nz/1.5/ai/token/usage_daily.json?apikey=your_key_here&client_id=1&key_id=3f6c2a9e-8b14-4d7a-9c5e-1a2b3c4d5e6f&month=9&year=2026'

response = requests.get(uri)

Response

200:

application/json
{
    "return": {
        "period": "2026-9",
        "totals": {
            "requests": 250,
            "prompt_tokens": 520000,
            "completion_tokens": 90000,
            "cached_tokens": 120000,
            "estimated_cost_nzd": 0.4,
            "failed_requests": 3
        },
        "days": [
            {
                "date": "2026-09-26",
                "requests": 110,
                "prompt_tokens": 240000,
                "completion_tokens": 40000,
                "cached_tokens": 50000,
                "estimated_cost_nzd": 0.175,
                "failed_requests": 1,
                "complete": true,
                "models": {
                    "Qwen/Qwen3.6-27B": 0.175
                }
            },
            {
                "date": "2026-09-27",
                "requests": 140,
                "prompt_tokens": 280000,
                "completion_tokens": 50000,
                "cached_tokens": 70000,
                "estimated_cost_nzd": 0.225,
                "failed_requests": 2,
                "complete": false,
                "models": {
                    "Qwen/Qwen3.6-27B": 0.225
                }
            }
        ]
    },
    "msg": "Successful",
    "status": true
}