---
title: "Kit check openapi | Agent Ready Checklist"
description: "Kit check openapi: OpenAPI linked and valid. The command that runs it, the evidence it prints and what it cannot prove. It maps to AR-ACT-02, AR-READ-06."
canonical: https://agentreadychecklist.com/kit/openapi
site: "Agent Ready Checklist"
last_updated: 2026-11-05
section: "Kit"
---

# Kit check openapi | Agent Ready Checklist

> Kit check openapi: OpenAPI linked and valid. The command that runs it, the evidence it prints and what it cannot prove. It maps to AR-ACT-02, AR-READ-06.

Source: https://agentreadychecklist.com/kit/openapi
Site: Agent Ready Checklist
Last reviewed: 2026-11-05
Agent endpoints: https://agentreadychecklist.com/llms.txt (index), https://agentreadychecklist.com/openapi.json (API), https://agentreadychecklist.com/mcp (MCP server), https://agentreadychecklist.com/ask (search)
Access: https://agentreadychecklist.com/auth.md (no key). Pricing: https://agentreadychecklist.com/pricing.md (free).

# Kit check: OpenAPI linked and valid

The openapi check of the Verify Kit: Finds an OpenAPI URL from a home page link, a Link rel=service-desc header, /.well-known/api-catalog or /openapi.json, fetches it and checks it parses with an openapi field and a paths object. It maps to AR-ACT-02, AR-READ-06. On the pass fixture it reports: /openapi.json via home page link: openapi 3.1.0, 1 paths.

## Run it

```bash
curl -fsSL https://agentreadychecklist.com/kit/verify.sh | bash -s -- https://example.com --only=openapi
```

```bash
node verify.mjs https://example.com --only=openapi
```

## What it tests

Finds an OpenAPI URL from a home page link, a Link rel=service-desc header, /.well-known/api-catalog or /openapi.json, fetches it and checks it parses with an openapi field and a paths object.

## What it cannot prove

Does not lint the contract or call any operation.

## Requirements it maps to

-   [AR-ACT-02](https://agentreadychecklist.com/checklist/ar-act-02/)OpenAPI contract
-   [AR-READ-06](https://agentreadychecklist.com/checklist/ar-read-06/)Link the discovery files

## Evidence on the fixtures

The pass fixture

PASS /openapi.json via home page link: openapi 3.1.0, 1 paths

The js-only fixture

FAIL no OpenAPI document found (looked at 2 candidates)

The 403 fixture

FAIL no OpenAPI document found (looked at 2 candidates)

## The one-line sketch

The shipped script is more careful than this sketch, which shows the idea in one line of shell.

```bash
for p in /openapi.json /.well-known/api-catalog; do curl -s "$ORIGIN$p" | jq -e ".openapi // .linkset" >/dev/null && echo "found $p"; done
```

## Sources

-   [rfc-editor.org/rfc/rfc9727](https://www.rfc-editor.org/rfc/rfc9727)read 2026-11-04

Last reviewed 2026-11-05. AgentReady v2.0, read 2026-11-04.