Skip to main content
GET
/
api
/
v1
/
sequencing
/
batches
GET sequencing/batches instances
curl --request GET \
  --url https://app.onecodex.com/api/v1/sequencing/batches \
  --header 'X-API-Key: <api-key>'
[
  {
    "$uri": "/api/v1/sequencing/a1b2c3d4e5f67890",
    "batch_number": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "name": "<string>",
    "owner": {
      "type": "<unknown>",
      "pattern": "<unknown>",
      "example": "<unknown>"
    },
    "status": "registered"
  }
]

Documentation Index

Fetch the complete documentation index at: https://developer.onecodex.com/llms.txt

Use this file to discover all available pages before exploring further.

GET all Sequencing Batch instances. Returns a paginated list of Sequencing Batches.

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
page
integer<int32>
default:1

Page number. Defaults to 1. See Pagination for more details.

​
per_page
integer<int32>
default:50

Number of requested paginated records. Defaults to 50. See Pagination for more details.

​
sort
object

Optional Mongo-style JSON sort clause, e.g., sort={"created_at": true} to sort by created_at (descending)

​
where
object

Optional Mongo-style JSON filter clause, e.g., where={"$uri": {"$eq": "/api/v1/samples/0ee172af60e84f61"}}

Response

200 - application/json

Successful operation

​
$uri
string
Pattern: ^/api/v1/sequencing/batches\/[^/]+$
Example:

"/api/v1/sequencing/a1b2c3d4e5f67890"

​
batch_number
string

A unique batch number.

​
created_at
string<date-time>

Timestamp for when the object was created on the One Codex platform, encoded as a RFC 3339 timestamp.

​
name
string

A human-readable name for the sequencing batch.

​
owner
object

The user that created the sequencing batch.

​
status
enum<string>

The current status of the sequencing batch.

Available options:
registered,
shipped_to_lab,
received_at_lab,
extracting,
preparing_library,
done,
canceled