---
title: "Get Audits Public"
method: GET
path: "/get-audits"
tags: ["public-api"]
---

# Get Audits Public

`GET /get-audits`

## Request

- Base URL: `https://api.trakkr.ai`
- URL: `https://api.trakkr.ai/get-audits`
- Auth: HTTP bearer

List site audits for a brand, or fetch one by ID.

Each audit is a snapshot of the brand's site at a point in time, with
issue counts, an overall score, and the detected CMS platform. To go
deeper, call /get-audit-findings with the audit_id (or omit it to use
the latest complete audit).

Read-only. Audits are scheduled server-side and cannot be triggered here.

## Query parameters

- `brand_id` string, uuid, required: Brand UUID
- `audit_id` string, nullable: Optional audit UUID to fetch a single record
- `status` string, nullable: Filter by audit status (e.g. 'complete')
- `limit` integer: Max audits to return
- `period` string, nullable: A frozen calendar period instead of a rolling window: a month as YYYY-MM (2026-08) or a quarter as YYYY-Qn (2026-Q3). A closed month is read from the archive frozen when it closed; the open month is computed to date. When period is given, days is ignored and the response carries a `period` block saying exactly what was resolved. Definitions: /get-metrics.

## Response `200`

Successful Response

- AuditsListResponse: GET /get-audits response.
  - `period` PeriodMeta: What a period-scoped response actually resolved.
    - `key` string, required
    - `kind` string, required
    - `label` string, required
    - `start` string, required
    - `end` string, required
    - `status` string, required
    - `source` string, required
    - `frozen_at` string, nullable
    - `pipeline_version` string, nullable
    - `restated_at` string, nullable
    - `restatements` object[]
    - `coverage` object
    - `fields_computed` string[]
    - `fields_missing` string[]
    - `notes` string[]
    - `months` object, nullable
    - `rank_source` string, nullable
  - `audits` AuditSummaryItem[], required
    - `id` string, required
    - `brand_id` string, required
    - `site_url` string, nullable
    - `status` string, nullable
    - `overall_score` integer, nullable
    - `pages_crawled` integer, nullable
    - `critical_issues` integer, nullable
    - `high_issues` integer, nullable
    - `medium_issues` integer, nullable
    - `low_issues` integer, nullable
    - `detected_platform` string, nullable
    - `created_at` string, nullable
    - `completed_at` string, nullable
  - `total` integer, required

## Other responses

- `401`: Missing, malformed, or expired credentials
- `402`: The current plan does not fund this operation
- `403`: Invalid credentials, missing brand access, or insufficient role
- `422`: Validation Error
- `429`: Rate limit exceeded
- `500`: The operation failed
- `503`: Authentication, entitlement, or a required dependency is temporarily unavailable

---

[API](https://skmtc.dev/trakkr/apis/trakkr-api.md) · [All operations](https://skmtc.dev/trakkr/apis/trakkr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trakkr/apis/trakkr-api/revisions/189a9e76b8d5?raw)