---
title: "Get agent usage"
method: GET
path: "/api/apps/{app_id}/agent-configs/usage"
---

# Get agent usage

`GET /api/apps/{app_id}/agent-configs/usage`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/apps/{app_id}/agent-configs/usage`
- Auth: HTTP bearer

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the integration credits each of the app's agents used in the workspace's current billing period.

This is limited to 60 requests a minute per app for each workspace's personal API keys, so every key in a workspace shares one allowance. Some workspaces have a different limit.

<Note>This endpoint accepts a personal API key, including a read-only one, from anyone with access to the app, viewers included. Workspace API keys are not authorized for it.</Note>

## Path parameters

- `app_id` string, required: ID of the app whose agents to read.

## Response `200`

Integration credits used by each agent.

- AgentUsageResponse: Integration credits the app's agents used in the current billing period.
  - `usage_by_agent` object: Integration credits each agent used in the workspace's current billing period, keyed by agent name. An agent that hasn't used any is left out.

## Other responses

- `401`: Missing or invalid credentials.
- `403`: You don't have access to this app, or you used a workspace API key.
- `404`: App not found.
- `429`: Too many requests for this app in the last minute from personal API keys in your workspace.

## Changes

- **2026-10-11** `80287813ab84`: 1 info
  - the endpoint scheme security `PersonalAccessTokenAuth` was added to the API
- **2026-09-30** `63675fa5257c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/base44/apis/base44-app-management-api/changes/api/apps/:app_id/agent-configs/usage/get.md)

---

[API](https://skmtc.dev/base44/apis/base44-app-management-api.md) - [All operations](https://skmtc.dev/base44/apis/base44-app-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/base44/apis/base44-app-management-api/revisions/c534f09cf314?raw)