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

<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-09-30** `63675fa5257c` — 1 info
  - endpoint added

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

---

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