---
title: "POST sequencing instances_batches_register"
method: POST
path: "/api/v1/sequencing/batches/register"
---

# POST sequencing instances_batches_register

`POST /api/v1/sequencing/batches/register`

## Request body

- object
  - `batch_name` string, required — A human-readable name for the sequencing batch.
  - `return_tracking_numbers` string[], required — One or more tracking numbers associated with the sample shipment(s) to the lab.
  - `samples` object[], required — The tube barcodes, specimen type, and sequencing depth for each sample to be sequenced.
    - `sequencing_depth` 'Standard' | 'Deep', required
    - `specimen_type` 'Human stool' | 'Microbial cell culture', required
    - `tube_barcode` string, required

## Response `200`

OK

- object
  - `batch` SequencingBatches, required
    - `$uri` string, required
    - `batch_number` string, required — A unique batch number.
    - `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.
    - `name` string, nullable, required — A human-readable name for the sequencing batch.
    - `owner` object, required — The user that created the sequencing batch.
      - `__DOLLAR_REF__` string, uri
    - `status` 'registered' | 'shipped_to_lab' | 'received_at_lab' | 'extracting' | 'preparing_library' | 'sequencing' | 'quality_control' | 'done' | 'canceled', required — The current status of the sequencing batch.
  - `samples` object[], required — The sample object associated with the tube barcode. This will be in an `awaiting_data` state until the lab has finished processing the physical sample.
    - `sample` object, required — The sample object associated with the tube barcode. Note this may be in a pending upload state if the lab has not finished processing the physical sample.
      - `__DOLLAR_REF__` string, uri
    - `tube_barcode` string, required — The tube barcode for the sample sent to the lab.

---

[API](https://skmtc.net/onecodex/apis/one-codex-api-v1.md) · [All operations](https://skmtc.net/onecodex/apis/one-codex-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onecodex/one-codex-api-v1/versions/fe9d9bfc8a6a/schema)