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

# GET assemblies instances

`GET /api/v1/assemblies`

## Request

- Base URL: `https://app.onecodex.com`
- URL: `https://app.onecodex.com/api/v1/assemblies`
- 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
  - `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.
  - `filename` string, nullable, required
  - `genome` object, nullable, required
    - `__DOLLAR_REF__` string, uri
  - `input_samples` object[], nullable, required
    - `__DOLLAR_REF__` string, uri
  - `job` object, nullable, required
    - `__DOLLAR_REF__` string, uri
  - `owner` object, required
    - `__DOLLAR_REF__` string, uri
  - `primary_annotation_set` object, nullable, required
    - `__DOLLAR_REF__` string, uri
  - `size` integer, nullable, required
  - `visibility` 'public' | 'shared' | 'private' | 'importing' | 'awaiting data', required: Enum for the v1 API `visibility` attribute. Note: this is legacy and only exists for backwards-compatibility in the public v1 API.

## Changes

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

[Operation history](https://skmtc.dev/onecodex/apis/one-codex-api-v1/changes/api/v1/assemblies/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)