# Get usage data programmatically using the Depot API (https://depot.dev/changelog/2025-09-18-api-usage-service)

> Published 2025-09-18

You can now programmatically access your organization's resource usage data. The [Usage Service](/docs/api/overview#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](https://github.com/depot/sdk-node):

```typescript
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)
```

## For AI Agents

The full site index is at [llms.txt](https://depot.dev/llms.txt). Append `.md` to any documentation, blog, changelog, or customer URL to fetch its markdown source directly.