---
title: "Get audits quota usage"
method: GET
path: "/audit/quota"
tags: ["Audit"]
---

# Get audits quota usage

`GET /audit/quota`

## Request

- Base URL: `https://api.foudroyer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.foudroyer.com/audit/quota`
- Auth: HTTP bearer

Returns monthly audit quota usage for the user (limit, used, remaining). Optionally pass pages_to_crawl to check if starting an audit with that many pages is allowed. User must own the website.

## Query parameters

- `website_id` string, required
- `pages_to_crawl` number

## Response `200`

Quota limit, used, remaining, and optionally can_start for requested pages

- AuditCheckQuotaOutputDto
  - `quota_limit` number, required: Monthly quota limit for audits
  - `quota_used` number, required: Pages already used this month
  - `quota_remaining` number, required: Remaining pages in the monthly quota
  - `requested_pages` number, required: Requested pages for the audit
  - `can_start` boolean, required: Whether the audit can be started

---

[API](https://skmtc.dev/foudroyer/apis/foudroyer-api.md) - [All operations](https://skmtc.dev/foudroyer/apis/foudroyer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/foudroyer/apis/foudroyer-api/revisions/5b917c67e013?raw)
