---
title: "GET genomes instances"
method: GET
path: "/api/v1/genomes"
---

# GET genomes instances

`GET /api/v1/genomes`

## Request

- Base URL: `https://app.onecodex.com`
- URL: `https://app.onecodex.com/api/v1/genomes`
- Auth: API key in header `X-API-Key`

## Query parameters

- `page` integer
- `per_page` integer
- `sort` string, nullable
- `where` string, nullable

## Response `200`

OK

- object[]
  - `$uri` string, required
  - `assemblies` object[], required
    - `__DOLLAR_REF__` string, uri
  - `created_at` string, date-time, required: Timestamp for when the object was created on the One Codex platform, encoded as a [RFC 3339](https://www.ietf.org/rfc/rfc3339.txt) timestamp.
  - `description` string, nullable, required
  - `name` string, nullable, required
  - `primary_assembly` object, nullable, required
    - `__DOLLAR_REF__` string, uri
  - `tags` object[], required
    - `__DOLLAR_REF__` string, uri
  - `taxon` object, required
    - `__DOLLAR_REF__` string, uri

## Changes

- **2026-11-03** `3be5a5f9bf7d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/onecodex/apis/one-codex-api-v1/changes/api/v1/genomes/get.md)

---

[API](https://skmtc.dev/onecodex/apis/one-codex-api-v1.md) - [All operations](https://skmtc.dev/onecodex/apis/one-codex-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/onecodex/apis/one-codex-api-v1/revisions/3be5a5f9bf7d?raw)