# Download the OpenAPI document

`GET /api/openapi.json` - [human page](https://aicdapi.com/api-reference#getOpenApiDocument)

**Release status.** Available

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.

**Authentication.** No credentials. This endpoint is public.

### Example request

```bash
curl -X GET 'https://aicdapi.com/api/openapi.json'
```

### Response 200

The OpenAPI 3.1 document.

| Field | Type | Required | Bounds | Description |
| --- | --- | --- | --- | --- |
| `openapi` | string | yes | length 1..∞ |  |

Example response:

```json
{
  "openapi": "3.1.0"
}
```

### Errors

| Status | `error.code` | Description |
| --- | --- | --- |
| **500** | `internal_error` | The bundled document could not be read. This is not expected in normal operation. |

### Behaviour

- **Caching.** public, s-maxage=3600. The document is identical for every caller, so a shared cache may serve it.