Monthly Usage History

GET https://api.podengine.ai/api/v1/teams/usage/monthly

Get monthly usage history for your team over the past N months.

Example request

curl -X GET "https://api.podengine.ai/api/v1/teams/usage/monthly" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_TOKEN"

const options = {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
  }
};

fetch("https://api.podengine.ai/api/v1/teams/usage/monthly", options)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

import requests

headers = {
    "Content-Type": "application/json",
    "Authorization": "YOUR_API_TOKEN"
}

response = requests.get("https://api.podengine.ai/api/v1/teams/usage/monthly", headers=headers)
print(response.json())

using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "YOUR_API_TOKEN");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

var response = await client.GetAsync("https://api.podengine.ai/api/v1/teams/usage/monthly");
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.podengine.ai/api/v1/teams/usage/monthly", nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Authorization", "YOUR_API_TOKEN")
	
	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

import { PodEngine } from '@podengine/sdk';

const pe = new PodEngine({ apiKey: process.env.PODENGINE_API_KEY });

const data = await pe.usage.getMonthly({
  months: 6,
});

console.log(data);

import os

from podengine import PodEngine

pe = PodEngine(api_key=os.environ["PODENGINE_API_KEY"])

data = pe.usage.get_monthly(
    months=6,
)

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "months": [
      {
        "periodStart": "2026-01-15T09:30:00.000Z",
        "periodEnd": "2026-01-15T09:30:00.000Z",
        "totalUsage": 0,
        "usageByAlias": {
          "key": 0
        }
      }
    ],
    "limits": {
      "key": 0
    }
  }
}

Request

Query parameters

monthsnumberdefault 61 – 24

Number of months of history to return

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired2 fields

monthsarray of objectrequired4 fields

Usage period entries sorted by period start ascending

periodStartstringrequireddatetime

Inclusive start of the usage period (ISO 8601, UTC)

periodEndstringrequireddatetime

Exclusive end of the usage period — the reset instant (ISO 8601, UTC)

totalUsagenumberrequiredmin 0

Total requests in this usage period

usageByAliasrecordrequired

Usage count per alias for this usage period

limitsrecordrequired

Current per-period limits per alias