# GenReady AI API

**Canonical:** https://apis.io/apis/genready-ai/genready-ai-api/  
**Provider:** GenReady AI — https://apis.io/providers/genready-ai/  
**Documentation:** https://genready.ai/docs/api

GenReady AI API is published by [GenReady AI](https://apis.io/providers/genready-ai/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

GenReady AI API as documented publicly: 33 operations. Contract generated from the documentation by API Evangelist (2026-11-09); not the provider's own document.

## Operations (33)

| Method | Path | Summary |
|---|---|---|
| GET | `/` | GET / |
| GET | `/.well-known/mcp/server-card.json` | GET /.well-known/mcp/server-card.json |
| POST | `/analyze` | Submit a URL for AI readiness analysis. |
| POST | `/api/v1/analyze` | POST /api/v1/analyze |
| GET | `/api/v1/artifacts/{kind}` | Get a robots.txt, llms.txt or JSON-LD block to commit. |
| GET | `/api/v1/domains` | List the domains this account monitors. |
| GET | `/api/v1/domains/{id}/fix-plan` | The fix plan from the domain's most recent completed analysis. |
| POST | `/api/v1/domains/{id}/site-analyses` | Scan a whole verified site without a person in the loop. |
| PATCH | `/api/v1/findings/{id}` | Record what you did about a finding. |
| GET | `/api/v1/findings/robots.gptbot_blocked~a1b2c3d4e5f6a7b8` | Retrieve a specific finding. |
| POST | `/api/v1/findings/verify` | Check whether fixes landed, with one fetch per finding instead of a paid re-scan. |
| GET | `/api/v1/reports/{reportid}` | GET /api/v1/reports/{reportId} |
| GET | `/api/v1/reports/{reportid}/status` | GET /api/v1/reports/{reportId}/status |
| GET | `/api/v1/site-analyses/{id}/fix-plan` | The plan for one specific run, by run id. |
| POST | `/ask` | Answering Natural-Language Questions at /ask |
| GET | `/help` | genready.ai sends markdown for its home page, help center and blog. |
| GET | `/page` | GET /page |
| GET | `/ping` | Health check endpoint. |
| GET | `/reports` | List your analysis reports with pagination and filtering. |
| GET | `/reports/{id}` | Retrieve a completed analysis report. |
| GET | `/reports/{id}/status` | Check analysis progress for a running or completed report. |
| GET | `/usage` | Check your current billing period usage. |
| GET | `/usage/daily` | Daily breakdown of API calls and reports for the current month. |
| GET | `/v1/customers` | Look up the customer with GET /v1/customers?email=... |
| POST | `/v1/customers` | If none exists, create one with POST /v1/customers. |
| POST | `/v1/invoices` | Create the invoice with POST /v1/invoices, passing customer_id and line items. |
| POST | `/v1/invoices/{id}/send` | Send it with POST /v1/invoices/{id}/send. |
| GET | `/webhooks` | List all your webhooks. |
| POST | `/webhooks` | Create a new webhook. |
| DELETE | `/webhooks/{id}` | Delete a webhook permanently. |
| PATCH | `/webhooks/{id}` | Update a webhook's URL, events, or active status. |
| GET | `/webhooks/{id}/deliveries` | View delivery history for a webhook (paginated). |
| POST | `/webhooks/{id}/test` | Send a test webhook payload to verify your endpoint. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/genready-ai/openapi/_ae-authored/genready-ai-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/genready-ai/json-schema/genready-ai-post-api-v1-analyze-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/genready-ai/json-schema/genready-ai-post-api-v1-findings-verify-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/genready-ai/json-schema/genready-ai-get-reports-id-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/genready-ai/json-schema/genready-ai-get-api-v1-findings-robots-gptbot-blocked-a1-b2-c3-d4-e5-f6-a7-b8-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/genready-ai/json-schema/genready-ai-post-v1-invoices-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/genready-ai/json-schema/genready-ai-post-api-v1-domains-id-site-analyses-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/genready-ai/apis.yml

---

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