---
title: "Get account AEO usage"
method: GET
path: "/api/aeo/usage"
tags: ["AEO Usage"]
---

# Get account AEO usage

`GET /api/aeo/usage`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/aeo/usage`
- Auth: HTTP basic

Returns the account's AEO allowances and usage for the current billing cycle. The account is the one the API credentials belong to.

Each field is a `used`/`limit` pair. A `limit` of `null` means no limit. Which fields are filled in depends on the plan type:

| Field | Self-serve plans | Custom (contract) plans |
| --- | --- | --- |
| `sites` | Sites with active AEO tracking, against the plan's site limit. | `null` |
| `one_time_reports` | One-time reports created this cycle, against the monthly allowance. `limit` is `0` when the plan includes no reports. | `null` |
| `runs` | `null` | The pool that active sites and one-time reports share, in chats. Each site and report reserves one full scan (prompts × AI models × countries). |
| `refresh_chats` | Chats used by manual refreshes this cycle, against the monthly allowance. `limit` is `0` when the plan includes no manual refreshes. | Same |

## Response `200`

OK

- ApiAeoAccountUsageResp
  - `one_time_reports` ApiAeoUsageValueResp
    - `limit` integer, nullable: The plan's limit. `null` means no limit.
    - `used` integer: Amount used in the current billing cycle.
  - `refresh_chats` ApiAeoUsageValueResp
    - `limit` integer, nullable: The plan's limit. `null` means no limit.
    - `used` integer: Amount used in the current billing cycle.
  - `runs` ApiAeoUsageValueResp
    - `limit` integer, nullable: The plan's limit. `null` means no limit.
    - `used` integer: Amount used in the current billing cycle.
  - `sites` ApiAeoUsageValueResp
    - `limit` integer, nullable: The plan's limit. `null` means no limit.
    - `used` integer: Amount used in the current billing cycle.

## Other responses

- `400`: Bad request. The request is malformed or failed validation.
- `401`: Unauthorized. The credentials are missing or invalid.
- `403`: Forbidden. `error_code` is `AccessForbidden`, and `errors[0].code` names the cause: - `AeoPlanNotFound`: the account has no active AEO plan.
- `429`: Too many requests. The rate limit was exceeded.

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)