---
title: "Gene Literature"
method: POST
path: "/public/v1/genes/literature"
tags: ["public-genes"]
---

# Gene Literature

`POST /public/v1/genes/literature`

## Request

- Base URL: `https://api.helena.bio` (the document declares no server; this is the origin it was published from)
- URL: `https://api.helena.bio/public/v1/genes/literature`
- Auth: none declared

## Request body

- GeneLiteratureRequest
  - `gene_id` string, required
  - `request_id` string, required
  - `snapshot_id` string, nullable
  - `limit` integer
  - `sort` 'relevance' | 'newest' | 'oldest'
  - `cursor` string, nullable

## Response `200`

Successful Response

- GeneLiteratureResponse
  - `schema_version` '1.0'
  - `gene_id` string, required
  - `canonical_symbol` string, required
  - `request_id` string, required
  - `snapshot_id` string, required
  - `owner` 'canonical_literature_mining'
  - `query` string, required
  - `captured_at` string, required
  - `capture_sha256` string, required
  - `owner_contract_version` '1.0'
  - `owner_returned_count` integer, required
  - `returned` integer, required
  - `filtered_unsafe_link_count` integer, required
  - `records` DiscoveryRecord[], required
    - `work_id` string, required
    - `pmid` string, nullable, required
    - `title` string, required
    - `journal` string, nullable, required
    - `publication_date` string, nullable, required
    - `doi` string, nullable, required
    - `source_url` string, required
    - `match_types` string[], required
    - `rank_score` number, required
    - `relation` 'discovery_result_not_curated_gene_association'
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required
  - `semantic_index_used` boolean, required
  - `semantic_degraded_reason` string, nullable, required
  - `graph_used` boolean, required
  - `graph_version` string, nullable, required
  - `graph_degraded_reason` string, nullable, required
  - `limits` string[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/helena/apis/helix-insight-variant-analysis-service.md) · [All operations](https://skmtc.dev/helena/apis/helix-insight-variant-analysis-service/llms.txt) · [OpenAPI document](https://skmtc.dev/helena/apis/helix-insight-variant-analysis-service/revisions/fe51fd20cdf1?raw)