> This page is for Developer Documentation.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.benchling.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.benchling.com/_mcp/server.

# List StructuredTableRow items

GET https://{tenant_name}.benchling.com/api/v3/document-part-registration-table-create-entities/{document_part_registration_table_create_entities_id}/rows/items

List StructuredTableRow items.

Reference: https://docs.benchling.com/docs/api/benchling-api/document-part-registration-table-create-entities/rows-list

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Path parameters

- `document_part_registration_table_create_entities_id` (string, required) — ID of the DocumentPartRegistrationTableCreateEntities.

### Query parameters

- `nextToken` (string, optional) — Token for pagination
- `pageSize` (integer, optional) — Number of results to return. Defaults to 50, maximum of 100.

### Headers

- `EARLY-ACCESS` (string, optional) — Set to true to access beta operations via /api/v3.

## Response

### 200

OK

- `items` (list of StructuredTableRow, optional)
- `nextToken` (string, optional, nullable)

## Errors

### 400 Bad Request Error

Bad Request

- `detail` (GeneralErrorDetail, required, nullable)
- `instance` (string, required)
- `status` (integer, required)
- `title` (string, required, nullable)
- `type` (string, required)
- `invalidId` (string, optional)

### 403 Forbidden Error

Forbidden

- `detail` (GeneralErrorDetail, required, nullable)
- `instance` (string, required)
- `status` (integer, required)
- `title` (string, required, nullable)
- `type` (string, required)
- `invalidId` (string, optional)

### 404 Not Found Error

Not Found

- `detail` (GeneralErrorDetail, required, nullable)
- `instance` (string, required)
- `status` (integer, required)
- `title` (string, required, nullable)
- `type` (string, required)
- `invalidId` (string, optional)

### 429 Too Many Requests Error

Too Many Requests

- `detail` (TooManyRequestsErrorDetail, required, nullable)
- `instance` (string, required)
- `status` (integer, required)
- `title` (string, required, nullable)
- `type` (string, required)
- `invalidId` (string, optional)

### 500 Internal Server Error

Internal Server Error

- `detail` (InternalServerErrorDetail, required, nullable)
- `instance` (string, required)
- `status` (integer, required)
- `title` (string, required, nullable)
- `type` (string, required)
- `errorId` (string, optional)

## Types

### StructuredTableRow

Specifies a row within a table.

- `__typename` (string, optional)
- `cells` (list of StructuredTableCell, optional) — Lists cells in the row in column order.
- `documentPart` (DocumentPartRef, optional) — Specifies the document part that contains this row.
- `id` (string, optional) — Identifies the table row.
- `isArchived` (boolean, optional) — Specifies whether this row has been archived.
- `isSubmittable` (boolean, optional) — Specifies whether this row can be submitted in its current state.
- `result` (ResultRef, optional, nullable) — Specifies the result associated with this row after submission. Present on results tables once a result has been created for the row, including when the row has unsubmitted changes; null before submission and on registration and inventory tables.
- `rowId` (string, optional) — Specifies the stable row identifier within the table.
- `rowIndex` (integer, optional) — Specifies the row's absolute position within the table, zero-based.
- `submissionStatus` (enum, optional) — Specifies the submission status of this row: unsubmitted, submitted, has unsubmitted changes, or unevaluated when the table has not been evaluated since the last write.
  - Allowed values: `UNSUBMITTED`, `SUBMITTED`, `HAS_UNSUBMITTED_CHANGES`, `UNEVALUATED`

### GeneralErrorDetail

- string
- map from string to any

### TooManyRequestsErrorDetail

- string
- map from string to any

### InternalServerErrorDetail

- string
- map from string to any

### StructuredTableCell

Specifies a cell within a table row, using typed input values instead of freeform text.

- `__typename` (string, optional)
- `errors` (list of CellError, optional) — Lists evaluation, validation, and unsupported-value errors present on the cell. Empty when the cell has no errors.
- `evaluationValue` (BenchlingValue, optional, nullable) — Specifies the evaluated value computed by formula evaluation, when present. Read-only.
- `format` (TableCellFormat, optional, nullable) — Specifies formatting properties applied to the cell, when present.
- `inputValue` (BenchlingValue, optional) — Specifies the cell input value as entered or stored in the table.
- `mergeRange` (TableMergeRange, optional, nullable) — Specifies the merged region span on the anchor cell. Present only on anchor cells.
- `mergeRangeParent` (MergedCellAnchor, optional, nullable) — Specifies coordinates of the anchor cell. Present on cells within a merged region that are not the anchor.

### DocumentPartRef

- `__typename` (string, optional)
- `id` (string, optional)

### ResultRef

- `__typename` (string, optional)
- `id` (string, optional)

### CellError

Specifies a single error present on a table cell. The error type field distinguishes evaluation failures, validation failures, and values the API cannot represent; message is the error description.

- `__typename` (string, optional)
- `errorType` (enum, optional) — Specifies whether the error is an evaluation failure, a validation failure, or a value the API cannot represent.
  - Allowed values: `EVALUATION`, `VALIDATION`, `UNSUPPORTED_VALUE`
- `message` (string, optional) — Specifies the error message.
- `type` (string, optional, nullable) — Specifies the display name for the specific error, such as reference error or value error. Populated for evaluation errors; null for validation errors.

### BenchlingValue

Types of values that Benchling can interpret.

- `__typename`: `ArrayValue` (ArrayValue)
  - `value` (list of SingularBenchlingValue, optional)
- `__typename`: `BooleanValue` (BooleanValue)
  - `value` (boolean, optional) — The boolean value.
- `__typename`: `DateTimeValue` (DateTimeValue)
  - `value` (string, optional) — The datetime value with UTC as the timezone.
- `__typename`: `DateValue` (DateValue)
  - `value` (date, optional) — The date value.
- `__typename`: `DecimalValue` (DecimalValue)
  - `value` (string, optional, nullable) — The decimal value in a string representation
  - `numericValue` (double, optional, nullable, deprecated) — Deprecated. The float representation of the decimal value.
- `__typename`: `IntegerValue` (IntegerValue)
  - `value` (integer, optional) — The integer value.
- `__typename`: `JsonValue` (JsonValue)
  - `value` (SingularBenchlingValueDiscriminatorMappingJsonValueValue, optional) — The JSON value.
- `__typename`: `ObjectLinkListValue` (ObjectLinkListValue)
  - `value` (list of LinkableDomainObject, optional) — The list of objects that this value links to. Inaccessible objects may be returned instead if the object is not found with the current permission set.
- `__typename`: `ObjectLinkValue` (ObjectLinkValue)
  - `value` (LinkableDomainObject, optional) — The object that this value links to, or an Inaccessible object if not found with the current permission set.
- `__typename`: `TextAndUrlValue` (TextAndUrlValue)
  - `url` (string, optional) — The URL associated with the value. Please use `TextValue` if you don't want a URL.
  - `value` (string, optional) — The text value. It may or may not be an empty string.
- `__typename`: `TextValue` (TextValue)
  - `value` (string, optional) — The text value. It may or may not be an empty string.

### TableCellFormat

Specifies formatting properties applied to an entire table cell.

- `__typename` (string, optional)
- `alignment` (enum, optional) — Specifies horizontal text alignment for the cell, when set.
  - Allowed values: `LEFT`, `CENTER`, `RIGHT`
- `backgroundColor` (string, optional, nullable) — Specifies the background color applied to the cell, when set.
- `foregroundColor` (string, optional, nullable) — Specifies the text color applied to the cell, when set.
- `link` (string, optional, nullable) — Specifies a hyperlink URL applied to the cell, when set.
- `precision` (integer, optional, nullable) — Specifies the decimal precision used to display a numeric cell.
- `properties` (list of enum, optional) — Lists character style properties applied to the cell.
  - Allowed values: `BOLD`, `ITALIC`, `UNDERLINE`, `STRIKETHROUGH`, `IMPORTANT`
- `scientificNotation` (boolean, optional, nullable) — Specifies whether a numeric cell is displayed in scientific notation.

### TableMergeRange

Specifies the extent of a merged cell region, set on the anchor cell.

- `__typename` (string, optional)
- `mergeColSpan` (integer, optional) — Specifies the number of columns in the merged region, including the anchor cell.
- `mergeRowSpan` (integer, optional) — Specifies the number of rows in the merged region, including the anchor cell.

### MergedCellAnchor

Specifies coordinates of the anchor cell for a cell within a merged region.

- `__typename` (string, optional)
- `col` (integer, optional) — Specifies the zero-based column index of the anchor cell.
- `row` (integer, optional) — Specifies the zero-based row index of the anchor cell.

### SingularBenchlingValue

A union of value types that can appear as elements within an ArrayValue. Identical to BenchlingValue but excludes ArrayValue to prevent nesting. Keep in sync with BenchlingValue.

- `__typename`: `BooleanValue` (BooleanValue)
  - `value` (boolean, optional) — The boolean value.
- `__typename`: `DateTimeValue` (DateTimeValue)
  - `value` (string, optional) — The datetime value with UTC as the timezone.
- `__typename`: `DateValue` (DateValue)
  - `value` (date, optional) — The date value.
- `__typename`: `DecimalValue` (DecimalValue)
  - `value` (string, optional, nullable) — The decimal value in a string representation
  - `numericValue` (double, optional, nullable, deprecated) — Deprecated. The float representation of the decimal value.
- `__typename`: `IntegerValue` (IntegerValue)
  - `value` (integer, optional) — The integer value.
- `__typename`: `JsonValue` (JsonValue)
  - `value` (SingularBenchlingValueDiscriminatorMappingJsonValueValue, optional) — The JSON value.
- `__typename`: `ObjectLinkListValue` (ObjectLinkListValue)
  - `value` (list of LinkableDomainObject, optional) — The list of objects that this value links to. Inaccessible objects may be returned instead if the object is not found with the current permission set.
- `__typename`: `ObjectLinkValue` (ObjectLinkValue)
  - `value` (LinkableDomainObject, optional) — The object that this value links to, or an Inaccessible object if not found with the current permission set.
- `__typename`: `TextAndUrlValue` (TextAndUrlValue)
  - `url` (string, optional) — The URL associated with the value. Please use `TextValue` if you don't want a URL.
  - `value` (string, optional) — The text value. It may or may not be an empty string.
- `__typename`: `TextValue` (TextValue)
  - `value` (string, optional) — The text value. It may or may not be an empty string.

### SingularBenchlingValueDiscriminatorMappingJsonValueValue

The JSON value.

- map from string to any
- list of string
- string
- double
- boolean

### LinkableDomainObject

A union representing items that can be linked to. If you have a type that can be linked to, it can only be added once it's in beta.

- `__typename`: `AaSequence` (AaSequence)
  - `id` (string, optional)
- `__typename`: `Attachment` (Attachment)
  - `id` (string, optional)
- `__typename`: `Box` (Box)
  - `id` (string, optional)
- `__typename`: `Container` (Container)
  - `id` (string, optional)
- `__typename`: `CustomEntity` (CustomEntity)
  - `id` (string, optional)
- `__typename`: `DnaOligo` (DnaOligo)
  - `id` (string, optional)
- `__typename`: `DnaSequence` (DnaSequence)
  - `id` (string, optional)
- `__typename`: `DropdownOption` (DropdownOption)
  - `id` (string, optional)
- `__typename`: `Entry` (Entry)
  - `id` (string, optional)
- `__typename`: `Inaccessible` (Inaccessible)
  - `id` (string, optional)
- `__typename`: `Location` (Location)
  - `id` (string, optional)
- `__typename`: `MatrixPlate` (MatrixPlate)
  - `id` (string, optional)
- `__typename`: `Mixture` (Mixture)
  - `id` (string, optional)
- `__typename`: `Molecule` (Molecule)
  - `id` (string, optional)
- `__typename`: `OligoConjugate` (OligoConjugate)
  - `id` (string, optional)
- `__typename`: `OligoDuplex` (OligoDuplex)
  - `id` (string, optional)
- `__typename`: `Protein` (Protein)
  - `id` (string, optional)
- `__typename`: `Result` (Result)
  - `id` (string, optional)
- `__typename`: `RnaOligo` (RnaOligo)
  - `id` (string, optional)
- `__typename`: `RnaSequence` (RnaSequence)
  - `id` (string, optional)
- `__typename`: `Study` (Study)
  - `id` (string, optional)
- `__typename`: `WellPlate` (WellPlate)
  - `id` (string, optional)

## Examples

**Response**

```json
{
  "items": [
    {
      "__typename": "string",
      "cells": [
        {
          "__typename": "string",
          "errors": [
            {
              "__typename": "string",
              "errorType": "EVALUATION",
              "message": "string",
              "type": null
            }
          ],
          "evaluationValue": {
            "__typename": "string",
            "value": [
              {
                "__typename": "string",
                "value": true
              }
            ]
          },
          "format": {
            "__typename": "string",
            "alignment": null,
            "backgroundColor": null,
            "foregroundColor": null,
            "link": null,
            "precision": null,
            "properties": [
              "BOLD"
            ],
            "scientificNotation": null
          },
          "inputValue": {
            "__typename": "string",
            "value": [
              {
                "__typename": "string",
                "value": true
              }
            ]
          },
          "mergeRange": {
            "__typename": "string",
            "mergeColSpan": 1,
            "mergeRowSpan": 1
          },
          "mergeRangeParent": {
            "__typename": "string",
            "col": 1,
            "row": 1
          }
        }
      ],
      "documentPart": {
        "__typename": "string",
        "id": "string"
      },
      "id": "string",
      "isArchived": true,
      "isSubmittable": true,
      "result": {
        "__typename": "string",
        "id": "string"
      },
      "rowId": "string",
      "rowIndex": 1,
      "submissionStatus": "UNSUBMITTED"
    }
  ],
  "nextToken": "string"
}
```

**SDK Code**

```python
import requests

url = "https://{tenant_name}.benchling.com/api/v3/document-part-registration-table-create-entities/document_part_registration_table_create_entities_id/rows/items"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://{tenant_name}.benchling.com/api/v3/document-part-registration-table-create-entities/document_part_registration_table_create_entities_id/rows/items';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```