---
title: "Search Vep Cache"
method: GET
path: "/preprocessing/vep-cache/search"
tags: ["preprocessing", "admin"]
---

# Search Vep Cache

`GET /preprocessing/vep-cache/search`

## 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/preprocessing/vep-cache/search`
- Auth: none declared

Search the VEP annotation cache by variant coordinates or gene symbol.

Two modes:
- Variant lookup: provide chromosome + position (optionally ref + alt)
- Gene search: provide gene symbol

All queries use parameterized SQL (B1). Read-only, no locks.

## Query parameters

- `chromosome` string
- `position` integer
- `ref` string
- `alt` string
- `gene` string
- `limit` integer

## Response `200`

Successful Response

- VepCacheSearchResult: Response for GET /preprocessing/vep-cache/search.
  - `mode` string, required
  - `query_time_ms` integer
  - `status` string, nullable
  - `positive_hits` object[]
  - `negative_hits` object[]
  - `gene` string, nullable
  - `total_variants` integer
  - `consequence_breakdown` VepCacheConsequenceBreakdown[]
    - `consequence` string, required
    - `impact` string, required
    - `count` integer, required
  - `sample_variants` object[]

## 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)