---
title: "Get usage"
method: GET
path: "/team/usage"
tags: ["Team"]
---

# Get usage

`GET /team/usage`

## Request

- Base URL: `https://api.autumn.ai`
- URL: `https://api.autumn.ai/team/usage`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Read-only usage totals, daily credits, and per-member activity for personal accounts and teams.

## Query parameters

- `days` integer: Usage window in days.

## Response `200`

Credit and task usage for the selected window.

- object

## Other responses

- `400`: `invalid_request`: The request is invalid. Fix the field in `param` (see `detail`), or read `message`.
- `401`: `unauthorized`: Missing or invalid credentials. Send your full API key as `X-API-Key: <key>` or `Authorization: Bearer <key>`.
- `403`: `forbidden`: This account cannot access this resource. The same request fails with the same key.
- `422`: `invalid_request`: a field failed validation. `param` names it; `detail` is the validator output.
- `503`: `auth_unavailable`: Key verification is temporarily unavailable. Wait `retry_after` seconds, then send the request again.

---

[API](https://skmtc.dev/autumn-ai/apis/autumn-task-api.md) - [All operations](https://skmtc.dev/autumn-ai/apis/autumn-task-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autumn-ai/apis/autumn-task-api/revisions/78fb43699783?raw)