---
title: "Download the Lucis OpenAPI document (JSON)"
method: GET
path: "/openapi.json"
tags: ["Discovery"]
---

# Download the Lucis OpenAPI document (JSON)

`GET /openapi.json`

Returns the Lucis.life OpenAPI 3.1 document describing the public biomarker catalog, OAuth 2.0 token endpoint, typed errors, and rate-limit headers.

## Response `200`

OpenAPI 3.1 document.

- OpenApiDocument
  - `openapi` string, required — OpenAPI version, currently 3.1.0.
  - `info` object, required
    - `title` string, required
    - `version` string, required
    - `summary` string
    - `description` string
    - `contact` object
      - `name` string
      - `url` string, uri
    - `license` object
      - `name` string
      - `url` string, uri
  - `jsonSchemaDialect` string, uri
  - `servers` object[]
    - `url` string, uri, required
    - `description` string
  - `tags` object[]
    - `name` string, required
    - `description` string
  - `security` object[]
  - `paths` object, required
  - `components` object
    - `securitySchemes` object
    - `schemas` object
    - `headers` object
  - `externalDocs` object
    - `description` string
    - `url` string, uri

## Other responses

- `429` — Rate limit exceeded. Honour Retry-After and RateLimit.

---

[API](https://skmtc.dev/lucis/apis/lucis-public-api.md) · [All operations](https://skmtc.dev/lucis/apis/lucis-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lucis/lucis-public-api/revisions/9f890b2539af/schema)