---
title: "Genes"
method: GET
path: "/vocabularies/genes"
tags: ["vocabularies"]
---

# Genes

`GET /vocabularies/genes`

## Request

- Base URL: `/v3_0` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v3_0/vocabularies/genes`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fzj-inm1-bda/apis/siibra-api/docs/vocabularies/genes/get.ts> (a function with typed inputs; its response is checked against the schema)

HTTP get (filtered) genes

## Query parameters

- `find` string
- `page` integer
- `size` integer

## Response `200`

Successful Response

- PageGeneModel
  - `items` GeneModel[], required
    - `@type` string, required
    - `symbol` string, required
    - `description` string, required
  - `total` integer
  - `page` integer
  - `size` integer
  - `pages` integer

## Other responses

- `422`: Validation Error

## Changes

- **2025-03-17** `99fd3d467010`: 1 info
  - endpoint added
- **2024-07-08** `0364172305cb`: 1 breaking
  - api path removed without deprecation
- **2024-07-08** `376bc2a4a966`: 1 info
  - endpoint added
- **2023-12-15** `4079a1b2e4b6`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/fzj-inm1-bda/apis/siibra-api/changes/vocabularies/genes/get.md)

---

[API](https://skmtc.dev/fzj-inm1-bda/apis/siibra-api.md) - [All operations](https://skmtc.dev/fzj-inm1-bda/apis/siibra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fzj-inm1-bda/apis/siibra-api/revisions/5adffd5f8b23?raw)
