# Agent Ready API

**Canonical:** https://apis.io/apis/agent-ready-dev/agent-ready-api/  
**Provider:** Agent Ready — https://apis.io/providers/agent-ready-dev/  
**Base URL:** https://agent-ready.dev  
**Documentation:** https://agent-ready.dev/docs/api

Agent Ready API is one of 3 APIs that [Agent Ready](https://apis.io/providers/agent-ready-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agents, Website Scanning, NLWeb, and x402. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a getting-started guide.

REST API for agent-ready.dev scans, published as OpenAPI 3.1.0 at https://agent-ready.dev/api/v1/openapi.json (servers[] https://agent-ready.dev, info.contact support@agent-ready.dev). Eight operations: start a scan (POST /api/v1/scans, 202 + Location poll URL, optional Idempotency-Key with 24-hour retention), get a scan, list scans (cursor pagination), the public NLWeb /api/v1/ask endpoint (GET and POST, optional SSE streaming), the public POST /api/v1/scan/mcp that grades a live remote MCP server, and the x402/MPP pay-per-scan endpoint at /api/x402/scan (HTTP 402 challenge, USDC on Base). Bearer ar_live_ API keys (Pro plan) on the scans surface; ask, scan/mcp and x402 are key-free.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/scans` | Start a scan |
| GET | `/api/v1/scans` | List recent scans |
| GET | `/api/v1/scans/{id}` | Get a scan |
| GET | `/api/v1/ask` | Ask in natural language (NLWeb) |
| POST | `/api/v1/ask` | Ask in natural language (NLWeb), JSON-body form |
| POST | `/api/v1/scan/mcp` | Scan a live MCP server |
| GET | `/api/x402/scan` | x402 payment challenge for a paid scan |
| POST | `/api/x402/scan` | Run a scan, paid via x402 |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/agent-ready-dev/refs/heads/main/openapi/agent-ready-dev-openapi.yml
- **OpenAPI** — https://agent-ready.dev/api/v1/openapi.json
- **Documentation** — https://agent-ready.dev/docs/api
- **APIReference** — https://agent-ready.dev/docs/api/reference
- **GettingStarted** — https://agent-ready.dev/quickstart
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/agent-ready-dev/refs/heads/main/overlays/agent-ready-dev-openapi-overlay.yaml
- **Examples** — https://raw.githubusercontent.com/api-evangelist/agent-ready-dev/refs/heads/main/examples/agent-ready-dev-examples.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/agent-ready-dev/refs/heads/main/apis.yml

## Other Agent Ready APIs (2)

- [Agent Ready MCP Server](https://apis.io/apis/agent-ready-dev/agent-ready-mcp-server/)
- [Agent Ready A2A Agent](https://apis.io/apis/agent-ready-dev/agent-ready-a2a-agent/)

## Tags

Agents, Website Scanning, NLWeb, x402

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/agent-ready-dev/agent-ready-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/agent-ready-dev/.