# OpenAPI / Swagger Spec Discovery

> OpenAPI / Swagger Spec Discovery is a paid API for AI agents from intel.rallylive.ca, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Probes a website's common OpenAPI/Swagger spec locations and homepage links, then summarises the discovered spec including title, version, server URLs, paths, operations, and tags.

## Facts

- Endpoint: GET https://intel.rallylive.ca/site/openapi
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/openapi-swagger-spec-discovery-c2b1b990
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qaq5HnDhLeGGCI9qhT2JE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability openapi-swagger-spec-discovery-c2b1b990
```

Example prompt: Can you check if stripe.com has a publicly accessible OpenAPI or Swagger spec and summarise what you find — title, version, how many paths and operations it has, and what tags are listed?

## When to prefer this

Use this endpoint when you need to programmatically discover whether a website has a publicly accessible OpenAPI or Swagger spec, and want a summarised view of its structure (paths, operations, tags) without downloading and parsing the full spec yourself. Prefer this over manual probing or general web crawlers because it checks all standard spec locations plus homepage links in a single call and returns a structured summary ready for agent consumption.

## Known failure modes

- No spec found at any probed location — site does not expose a public OpenAPI/Swagger spec
- Homepage links do not include any API spec reference
- Site blocks automated requests, returning 403 or rate-limit errors
- Spec URL exists but is malformed or non-standard JSON
- Network timeout reaching the target domain
- Domain does not resolve or site is offline

## How this service works

OpenAPI / Swagger discovery: probes the common spec locations (/openapi.json, /swagger.json, /api-docs, /v1/openapi.json, /.well-known/openapi.json...) and any link on the homepage, then summarises the spec: title, version, server URLs, path and operation counts, tags. Find a site's machine-readable API. $0.01 per site.

## Output

A structured summary of the discovered OpenAPI/Swagger specification including: the spec URL where it was found, the API title, version, server URLs, total path count, operation count, and any tags defined in the spec. Returns null or an error if no spec is found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/openapi-swagger-spec-discovery-c2b1b990/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from intel.rallylive.ca](https://www.zero.xyz/host/intel.rallylive.ca/llms.txt)