> ## Documentation Index > Fetch the complete documentation index at: https://lightsage.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Site Audits > Returns every audited page and its actionable issues. Each page includes its score, priority, issue descriptions, evidence, and recommended fixes. This reads existing data and does not start a crawl. ## OpenAPI ````yaml /openapi.json get /v2/site-audits openapi: 3.1.0 info: title: Lightsage Public API description: Public API for Lightsage CLI and external integrations. version: 1.0.0 servers: - url: https://api.lightsage.com description: Production security: [] tags: - name: Status description: Check API availability and validate the calling API key. - name: Visibility description: >- Measure visibility, citations, competitors, and prompt performance across answer platforms. - name: Prompts description: Manage tracked prompts and topics, and inspect their stored runs. - name: Opportunities description: Review ranked opportunities computed from prompt visibility results. - name: Tasks description: Manage the persisted action queue and task lifecycle. - name: Site Audits description: Review website audit results and page-level findings. - name: Evals description: Define eval tasks, judges, subjects, and saved configurations. - name: Eval Templates description: >- Select reusable judges, targets, schedules, metadata, and runtime settings with `POST /v2/eval-templates`, then copy only those settings into prompt-specific evals with `POST /v2/evals/batch`. Templates never contain prompts and remain independent from evals created from them. - name: Eval Runs description: Start eval runs and inspect their lifecycle state. - name: Eval Results description: Review completed eval outcomes and diagnostic details. - name: Agent Preference description: >- Compare your company head-to-head with a tracked competitor. Create a comparison with `POST /v2/agent-preference/evals`, run it with `POST /v2/eval-runs`, then read which company agents recommended. - name: Agents description: List runnable coding-agent harness and model combinations. - name: Repositories description: Manage reusable Git repository workspaces. - name: Environments description: List reusable runtime environments without exposing secret values. - name: MCP Servers description: List reusable MCP server integrations without exposing credentials. - name: CLIs description: List reusable command-line interfaces without exposing setup commands. - name: Skills description: List reusable skills available to workflows and evals. paths: /v2/site-audits: get: tags: - Site Audits summary: List Site Audits description: >- Returns every audited page and its actionable issues. Each page includes its score, priority, issue descriptions, evidence, and recommended fixes. This reads existing data and does not start a crawl. operationId: v2_site_audits_list responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PublicSiteAuditListResponse' security: - LightsageApiKeyAuth: [] components: schemas: PublicSiteAuditListResponse: properties: audit: anyOf: - $ref: '#/components/schemas/PublicSiteAuditSnapshot' - type: 'null' pages: items: $ref: '#/components/schemas/PublicSiteAuditPage' type: array title: Pages type: object title: PublicSiteAuditListResponse PublicSiteAuditSnapshot: properties: url: type: string title: Url status: type: string title: Status description: >- Processing status of the audit run, unlike the per-page health `status`. score: anyOf: - type: integer - type: 'null' title: Score description: >- The overall audit score, from 0 to 100; it is not the mean of the per-page scores. grade: anyOf: - type: string - type: 'null' title: Grade generated_at: anyOf: - type: string - type: 'null' title: Generated At total_pages: type: integer title: Total Pages pages_with_issues: type: integer title: Pages With Issues failed_pages: type: integer title: Failed Pages description: Pages whose processing failed, not pages with issues. type: object required: - url - status - total_pages - pages_with_issues - failed_pages title: PublicSiteAuditSnapshot PublicSiteAuditPage: properties: site_id: type: string title: Site Id url: type: string title: Url title: anyOf: - type: string - type: 'null' title: Title score: anyOf: - type: integer - type: 'null' title: Score description: The page audit score, from 0 to 100. grade: anyOf: - type: string - type: 'null' title: Grade status: type: string title: Status description: Health band from the findings, not a processing state. priority: type: string title: Priority issue_count: type: integer title: Issue Count issues: items: $ref: '#/components/schemas/PublicSiteAuditIssue' type: array title: Issues type: object required: - site_id - url - status - priority - issue_count title: PublicSiteAuditPage PublicSiteAuditIssue: properties: id: type: string title: Id description: >- Check identifier such as `canonical-url`; the same id recurs on every page failing that check. category: type: string title: Category description: >- One of `access`, `delivery`, `discoverability`, `metadata`, or `quality`. severity: type: string enum: - warning - error title: Severity message: type: string title: Message recommendation: anyOf: - type: string - type: 'null' title: Recommendation evidence: anyOf: - type: string - type: 'null' title: Evidence type: object required: - id - category - severity - message title: PublicSiteAuditIssue securitySchemes: LightsageApiKeyAuth: type: apiKey in: header name: X-Lightsage-Api-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.