---
title: "List public Lucis biomarkers"
method: GET
path: "/v1/biomarkers/public"
tags: ["Catalog"]
---

# List public Lucis biomarkers

`GET /v1/biomarkers/public`

## Request

- Base URL: `https://www.lucis.life`
- URL: `https://www.lucis.life/v1/biomarkers/public`
- Auth: one of:
  - none
  - OAuth 2
    - Client credentials
    - Token URL: `https://www.lucis.life/oauth/token` scopes: `catalog.read`

Read-only JSON catalog of public panel markers and presentation metadata. No authentication required. Optional Bearer token with scope catalog.read is accepted and ignored for authorization.

## Query parameters

- `template` 'public-complete-eu' | 'public-light-eu' | 'public-v2-complete-uk' | 'public-v2-light-uk'

## Response `200`

Public catalog payload.

- BiomarkerCatalog
  - `success` true, required
  - `data` BiomarkerCatalogItem[], required
    - `id` integer: Internal numeric identifier when present.
    - `uuid` string, uuid, required: Stable public biomarker identifier.
    - `unit` string: Display unit for the marker, when applicable.
    - `computedInternally` boolean: True when Lucis derives the marker rather than measuring it directly.
    - `premium` boolean: True when the marker is on a premium panel.
    - `metadata` object: Optional origin metadata on the public catalog item.
    - `category` object
      - `uuid` string, uuid, required
      - `type` string: Category key used in the Lucis catalog UI.
      - `imageUrl` string, uri
      - `translations` object[], required
        - `name` string, required: Localized biomarker or category name.
        - `description` string: Optional localized presentation text.
        - `locale` string, required: BCP 47 locale, for example en or fr.
    - `translations` object[], required
      - `name` string, required: Localized biomarker or category name.
      - `description` string: Optional localized presentation text.
      - `locale` string, required: BCP 47 locale, for example en or fr.

## Other responses

- `400`: Unknown catalog template or malformed query.
- `405`: Read-only catalog. POST, PUT, PATCH, and DELETE return a rate-limited method-not-allowed problem.
- `429`: Rate limit exceeded. Honour Retry-After and RateLimit.
- `500`: Unexpected server error.
- `502`: Upstream catalog origin failed.

---

[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.dev/lucis/apis/lucis-public-api/revisions/b8d10cf9d4ef?raw)