Get API usage

Your own API consumption, broken down per key, per endpoint and per day. The same figures the Usage panel in Settings renders.

This is API request usage, which is distinct from product credit consumption — API calls do not consume credits. For the credit balance see Credits.


GET /v1/usage

Authorization

Header	Type	Required
`Authorization`	`Bearer asky_sk_…`	required

Query parameters

Parameter	Type	Required	Description
`days`	`integer`	optional	Days of history, 1 to 400. Defaults to 30. Successful requests are retained for 90 days and failures for 400, so a window past 90 days shows errors more completely than successes.

Request

cURL


curl --request GET \
  --url 'https://api.askylabs.com/v1/usage' \
  --header 'Authorization: Bearer <api-key>'

Python


import requests
 
url = "https://api.askylabs.com/v1/usage"
 
headers = {"Authorization": "Bearer <api-key>"}
 
response = requests.get(url, headers=headers)
 
print(response.text)

JavaScript


const options = {method: 'GET', headers: {Authorization: 'Bearer <api-key>'}};
 
fetch('https://api.askylabs.com/v1/usage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

PHP


<?php
 
$curl = curl_init();
 
curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.askylabs.com/v1/usage",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <api-key>"
  ],
]);
 
$response = curl_exec($curl);
$err = curl_error($curl);
 
curl_close($curl);
 
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Go


package main
 
import (
    "fmt"
    "net/http"
    "io"
)
 
func main() {
 
    url := "https://api.askylabs.com/v1/usage"
 
    req, _ := http.NewRequest("GET", url, nil)
 
    req.Header.Add("Authorization", "Bearer <api-key>")
 
    res, _ := http.DefaultClient.Do(req)
 
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
 
    fmt.Println(string(body))
 
}

Ruby


require 'uri'
require 'net/http'
 
url = URI("https://api.askylabs.com/v1/usage")
 
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
 
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <api-key>'
 
response = http.request(request)
puts response.read_body

Response

200


{
  "data": {
    "period": { "start_date": "2026-07-14", "end_date": "2026-08-13" },
    "totals": { "requests": 4820, "errors": 31, "p95_ms": 212 },
    "keys": [
      { "api_key_id": "6e3fbbff-4230-421f-ae3a-3d4d63a83f10", "key_hint": "asky_sk_…gxSN", "requests": 4820, "errors": 31, "p95_ms": 212 }
    ],
    "by_endpoint": [
      { "endpoint": "asky_brands_list", "requests": 1204, "errors": 0, "p95_ms": 118 }
    ],
    "by_day": [
      { "day": "2026-08-13", "requests": 214, "errors": 2 }
    ],
    "rate_limit": { "limit": 300, "remaining": 299, "reset": 25 }
  },
  "request_id": "req_39ae1c78f0b2456d8e14"
}

401


{
  "error": {
    "code": "token_expired",
    "message": "This API key has expired. Roll it in Settings to get a replacement.",
    "request_id": "req_8f21c0aa47b1490d2e63"
  }
}

429


{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry after 24 seconds.",
    "request_id": "req_31c9ba7f0e5d4a118cc2"
  }
}

Response fields

Field	Type	Description
`data.period`	`object`	required
`data.totals`	`object`	required. `{ requests, errors, p95_ms }`
`data.keys`	`object[]`	required. Per key: `api_key_id`, `key_hint`, `requests`, `errors`, `p95_ms`
`data.by_endpoint`	`object[]`	required
`data.by_day`	`object[]`	required. `{ day, requests, errors }`
`data.rate_limit`	`object`	required. Current budget: `{ limit, remaining, reset }`
`request_id`	`string`	required. Also returned as the `x-request-id` header. Quote it when contacting support

Errors

Status	Code	When
400	`invalid_request`	A parameter is unknown or malformed. The message names it
401	`invalid_token`	The key is missing, malformed, or does not exist
401	`token_expired`	The key passed its expiry date
401	`token_revoked`	The key was revoked
429	`rate_limited`	Over 300 requests per minute. See the `Retry-After` header

Notes

Figures are live, not batched. A call made seconds ago is already counted, so this is safe to use as confirmation that an integration is working rather than waiting for an hourly rollup.

Rejected requests count too. A 401 from an expired key, a 429, or a 400 from a bad parameter all appear here. A key that has stopped working shows up as errors rather than as silence, which is the point.

Errors are split into client-caused and server-caused in the Settings panel. A 4xx is your request; a 5xx is ours.