Get usage data programmatically using the Depot API | Changelog

You can now programmatically access your organization's resource usage data. The Usage Service helps you integrate Depot usage metrics into your billing workflow and internal tools.

The Usage Service has two endpoints to retrieve usage data for specific time periods:

getProjectUsage: Get usage data for one specific project
getUsage: Get a comprehensive usage breakdown for your organization

For example, to get comprehensive usage for September 2025 using the Depot Node SDK:

import {depot, wkt} from '@depot/sdk-node'
const {timestampFromDate} = wkt

const headers = {
  Authorization: `Bearer ${process.env.DEPOT_TOKEN}`,
}

const request = {
  startAt: timestampFromDate(new Date('2025-09-01T00:00:00Z')),
  endAt: timestampFromDate(new Date('2025-09-30T23:59:59Z')),
}

const result = await depot.core.v1.UsageService.getUsage(request, {headers})

console.log(result.containerBuild)
console.log(result.githubActionsJobs)
console.log(result.storage)
console.log(result.agentSandbox)