Current Month Usage

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

Get your team's current month API usage and limits for each usage category, along with enabled feature flags and plan information.

API token required Markdown for LLMs

OpenAPI spec

Example request

Install & configure

curl -X GET "https://api.podengine.ai/api/v1/teams/usage/current" \
  -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/current", 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/current", 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/current");
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/current", 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.getCurrent();

console.log(data);

import os

from podengine import PodEngine

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

data = pe.usage.get_current()

print(data)

200

Example response

{
  "status": "OK",
  "data": {
    "periodStart": "2026-01-15T09:30:00.000Z",
    "periodEnd": "2026-01-15T09:30:00.000Z",
    "plan": "string",
    "featureFlags": {
      "s3Integration": true,
      "airtableIntegration": true,
      "applyPage": true
    },
    "aliases": [
      {
        "alias": "deepResearchRequests",
        "label": "string",
        "used": 0,
        "limit": 0,
        "baseLimit": 0,
        "purchasedUnits": 0
      }
    ],
    "totalUsed": 0,
    "projectUsage": {
      "projects": {
        "used": 0,
        "limit": 0
      },
      "guestProfiles": {
        "used": 0,
        "limit": 0
      }
    }
  }
}

Request

This endpoint takes no parameters.

Response

200 application/json

statusliteral: OKrequired

dataobjectrequired7 fields

periodStartstringrequireddatetime

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

periodEndstringrequireddatetime

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

planstringrequired

Current team plan tier

featureFlagsobjectrequired3 fields

Enabled feature flags for the team

s3Integrationboolean

airtableIntegrationboolean

applyPageboolean

aliasesarray of objectrequired6 fields

Usage breakdown per category

aliasenumrequired

The usage category identifier

deepResearchRequestsdiarizationRequestsepisodeLookupsexportCountpodcastLookupssearchCounttranscriptDownloadCounttranscriptionRequests

labelstringrequired

Human-readable label for this usage category

usednumberrequiredmin 0

Number of requests used in the current usage period

limitnumberrequirednullablemin 0

Limit per usage period (null = unlimited, 0 = disabled)

baseLimitnumberrequirednullablemin 0

The part of `limit` that comes from the plan or a negotiated limit, before usage packs (null = unlimited)

purchasedUnitsnumberrequiredmin 0

Units per usage period added by usage packs (0 when the team has none for this category)

totalUsednumberrequired

Total requests used across all categories in the current usage period

projectUsageobject2 fields

Monthly active project and guest profile usage

projectsobjectrequired2 fields

usednumberrequired

limitnumberrequirednullable

guestProfilesobjectrequired2 fields

usednumberrequired

limitnumberrequirednullable