---
title: "Scan a website for AI-agent readiness"
method: POST
path: "/api/v1/agentready/scan"
---

# Scan a website for AI-agent readiness

`POST /api/v1/agentready/scan`

## Request

- Base URL: `https://growaify.com`
- URL: `https://growaify.com/api/v1/agentready/scan`
- Auth: none declared

Runs 26 tests against a public website and answers one question per test: can an AI agent find it, understand the offer, reach the systems, trust the transaction, get to checkout, and pay. Returns a weighted score (discovery 20, understanding 20, access 15, trust 15, commerce 15, payment 15), the issues in plain language with a severity each, and the evidence for every test. A test that could not be measured is reported as `unmeasured` and is excluded from the score rather than counted against the site. Publicly reachable addresses only; private, loopback and link-local targets are refused. Rate limited to 6 scans per 10 minutes per address.

## Request body

- object
  - `url` string, required

## Response `200`

url, scanned_at, score {overall, band, categories, tests_total, tests_unmeasured}, issues {counts, items}, tests[] with id, category, question, weight, status (ok|partial|missing|unmeasured), severity, finding (written for the site owner), technical (the evidence), fix; fix_summary {files, count, note}; took_ms.

## Other responses

- `400`: the address is missing, or not publicly reachable
- `429`: more than 6 scans in 10 minutes from this address

---

[API](https://skmtc.dev/growaify/apis/growaify-autonomous-agent-commerce-api.md) · [All operations](https://skmtc.dev/growaify/apis/growaify-autonomous-agent-commerce-api/llms.txt) · [OpenAPI document](https://skmtc.dev/growaify/apis/growaify-autonomous-agent-commerce-api/revisions/d0ef0c0c2159?raw)