---
title: "Download the OpenAPI document"
method: GET
path: "/api/openapi.json"
tags: ["Public API specification"]
---

# Download the OpenAPI document

`GET /api/openapi.json`

## Request

- Base URL: `https://aicdapi.com`
- URL: `https://aicdapi.com/api/openapi.json`
- Auth: none required

Returns the complete OpenAPI 3.1 document for this API as JSON. Every documented operation, the MCP tool extension, and every schema live here. It is the same document the human API reference and the agent Markdown reference are generated from, so the three can never disagree. Responses are cached at the edge for one hour.

## Response `200`

The OpenAPI 3.1 document.

- GetOpenApiDocumentResponse
  - `openapi` string, required

## Other responses

- `500`: The bundled document could not be read. This is not expected in normal operation.

---

[API](https://skmtc.dev/aicdapi/apis/aicd-api.md) · [All operations](https://skmtc.dev/aicdapi/apis/aicd-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aicdapi/apis/aicd-api/revisions/0f3752fae465?raw)