---
title: "Run the free public website readiness scan"
method: POST
path: "/api/audit"
---

# Run the free public website readiness scan

`POST /api/audit`

## Request

- Base URL: `https://actablesite.com`
- URL: `https://actablesite.com/api/audit`
- Auth: none declared

Fetches public website material only. The unauthenticated API returns the first three checks; paid report access is completed through the human checkout flow and is not part of this public contract.

## Request body

- WebsiteRequest
  - `url` string, uri, required: Public HTTP or HTTPS website URL. Private and local-network targets are rejected.

## Response `200`

Public website scan completed.

- AuditResponse
  - `url` string, uri, required
  - `scannedAt` string, date-time, required
  - `score` integer, required
  - `grade` 'A' | 'B' | 'C' | 'D' | 'F', required
  - `summary` string, required
  - `checks` Check[], required
    - `id` string, required
    - `label` string, required
    - `status` 'pass' | 'warn' | 'fail', required
    - `evidence` string, required
    - `fix` string, required
    - `points` integer, required
    - `maxPoints` integer, required
  - `paid` false, required

## Other responses

- `400`: The request did not contain a valid public HTTP or HTTPS website URL.

---

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