> 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.

# Get DocumentPartResultsTable by ID

GET https://{tenant_name}.benchling.com/api/v3/document-part-results-table/{document_part_results_table_id}

Get a single DocumentPartResultsTable by ID.

Reference: https://docs.benchling.com/docs/api/benchling-api/documentpartresultstable/get

## Authentication

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

## Request

### Path parameters

- `document_part_results_table_id` (string, required) — ID of the DocumentPartResultsTable.

### Query parameters

- `returning` (string, optional) — Comma-separated list of top-level fields to include in each returned item. Cannot overlap with omit.
- `omit` (string, optional) — Comma-separated list of top-level fields to omit from each returned item. Cannot overlap with returning.

### Headers

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

## Response

### 200

OK

- `__typename` (string, optional)
- `columnDefinitions` (list of IStructuredTableColumnDefinition, optional)
- `createdAt` (string, optional)
- `id` (string, optional)
- `indentation` (integer, optional)
- `isEvaluated` (boolean, optional)
- `isSubmittable` (boolean, optional)
- `modifiedAt` (string, optional)
- `modifier` (PrincipalRef, optional, nullable)
- `name` (string, optional)
- `resultSchema` (ResultSchemaRef, optional, nullable)
- `rowCount` (integer, optional)
- `rows` (string, optional)
- `submissionStatus` (enum, optional)
  - Allowed values: `UNSUBMITTED`, `SUBMITTED`, `HAS_UNSUBMITTED_CHANGES`, `UNEVALUATED`
- `versionMetadata` (DocumentLikeVersionMetadata, optional) — Version metadata for a document such as an entry, template, or subtemplate. Identifies a specific content revision and records when that revision was produced. Use this to detect changes, pin a revision, or reference a particular version without loading the full version record.

## Errors

### 400 Document Part Results Table Get Request 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 Document Part Results Table Get Request Forbidden Error

Forbidden

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

### 404 Document Part Results Table Get Request 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 Document Part Results Table Get Request Too Many Requests Error

Too Many Requests

- `detail` (TooManyRequestsErrorBodyDetail, required, nullable)
- `instance` (string, required)
- `status` (integer, required)
- `title` (string, required, nullable)
- `type` (string, required)
- `invalidId` (string, optional)
- `violated-policies` (list of enum, optional) — The budget policies that rejected the request, in canonical order: `user`, `integration`, then `tenant`.
  - Allowed values: `user`, `integration`, `tenant`

### 500 Document Part Results Table Get Request Internal Server Error

Internal Server Error

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

## Types

### IStructuredTableColumnDefinition

### PrincipalRef

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

### ResultSchemaRef

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

### DocumentLikeVersionMetadata

Version metadata for a document such as an entry, template, or subtemplate. Identifies a specific content revision and records when that revision was produced. Use this to detect changes, pin a revision, or reference a particular version without loading the full version record.

- `__typename` (string, optional)
- `createdAt` (string, optional, nullable) — Specifies when this version was created. Versions are immutable; this is the time the parent document was last edited to produce this revision.
- `versionId` (string, optional) — Identifies this version of the document.

### GeneralErrorDetail

### TooManyRequestsErrorBodyDetail

### InternalServerErrorBodyDetail

### CustomColumnDefinition

Specifies a user-defined table column with no additional type-specific fields.

- `__typename` (string, optional)
- `allowsArrayValues` (boolean, optional) — Specifies whether cells in this column may hold multiple values.
- `cellValueType` (string, optional) — Specifies the cell value type for this column.
- `columnId` (string, optional) — Specifies the column identifier within the table.
- `isArchived` (boolean, optional) — Always false. Custom columns are not schema-backed.
- `isLocked` (boolean, optional) — Specifies whether the column width is locked against resizing.
- `isReadonly` (boolean, optional) — Specifies whether cells in this column are read-only.
- `isRequired` (boolean, optional) — Specifies whether a value is required in cells for this column.
- `name` (string, optional) — Specifies the column display name.
- `width` (double, optional, nullable) — Specifies the column width in pixels. Defaults to 100 when unset.

### LookupColumnDefinition

Specifies a table column whose value is derived from a lookup configuration.

- `__typename` (string, optional)
- `allowsArrayValues` (boolean, optional) — Specifies whether cells in this column may hold multiple values.
- `cellValueType` (string, optional) — Specifies the cell value type for this column.
- `columnId` (string, optional) — Specifies the column identifier within the table.
- `isArchived` (boolean, optional) — Always false. Lookup columns are not backed by a schema field.
- `isLocked` (boolean, optional) — Specifies whether the column width is locked against resizing.
- `isReadonly` (boolean, optional) — Specifies whether cells in this column are read-only.
- `isRequired` (boolean, optional) — Specifies whether a value is required in cells for this column.
- `lookupConfigId` (string, optional) — Specifies the API identifier of the lookup configuration.
- `name` (string, optional) — Specifies the column display name.
- `parentColumnId` (string, optional) — Specifies the column identifier of the source column whose values feed this lookup.
- `width` (double, optional, nullable) — Specifies the column width in pixels. Defaults to 100 when unset.

### SchemaFieldColumnDefinition

Specifies a table column backed by a schema field definition.

- `__typename` (string, optional)
- `allowsArrayValues` (boolean, optional) — Specifies whether cells in this column may hold multiple values.
- `cellValueType` (string, optional) — Specifies the cell value type for this column.
- `columnId` (string, optional) — Specifies the column identifier within the table.
- `fieldDefinitionApiId` (string, optional) — Specifies the API identifier of the schema field definition for this column.
- `isArchived` (boolean, optional) — Specifies whether the schema field backing this column has been archived.
- `isLocked` (boolean, optional) — Specifies whether the column width is locked against resizing.
- `isReadonly` (boolean, optional) — Specifies whether cells in this column are read-only.
- `isRequired` (boolean, optional) — Specifies whether a value is required in cells for this column.
- `name` (string, optional) — Specifies the column display name.
- `width` (double, optional, nullable) — Specifies the column width in pixels. Defaults to 100 when unset.

### SystemColumnDefinition

Specifies a system-managed table column with a predefined purpose.

- `__typename` (string, optional)
- `allowsArrayValues` (boolean, optional) — Specifies whether cells in this column may hold multiple values.
- `cellValueType` (string, optional) — Specifies the cell value type for this column.
- `columnGroup` (string, optional, nullable) — Specifies the logical grouping identifier for this column in certain table types, such as source or target in transfer tables or quantity or concentration in inventory tables. Null when the column has no group.
- `columnId` (string, optional) — Specifies the column identifier within the table.
- `isArchived` (boolean, optional) — Always false. System columns are not backed by a schema field.
- `isLocked` (boolean, optional) — Specifies whether the column width is locked against resizing.
- `isReadonly` (boolean, optional) — Specifies whether cells in this column are read-only.
- `isRequired` (boolean, optional) — Specifies whether a value is required in cells for this column.
- `name` (string, optional) — Specifies the column display name.
- `systemPurpose` (string, optional) — Specifies the system-defined purpose of this column.
- `width` (double, optional, nullable) — Specifies the column width in pixels. Defaults to 100 when unset.

## Examples

**Response**

```json
{
  "__typename": "__typename",
  "columnDefinitions": [
    {
      "__typename": "__typename",
      "allowsArrayValues": true,
      "cellValueType": "cellValueType",
      "columnId": "columnId",
      "isArchived": true,
      "isLocked": true,
      "isReadonly": true,
      "isRequired": true,
      "name": "name",
      "width": 1.1
    }
  ],
  "createdAt": "createdAt",
  "id": "id",
  "indentation": 1,
  "isEvaluated": true,
  "isSubmittable": true,
  "modifiedAt": "modifiedAt",
  "modifier": {
    "__typename": "__typename",
    "id": "id"
  },
  "name": "name",
  "resultSchema": {
    "__typename": "__typename",
    "id": "id"
  },
  "rowCount": 1,
  "rows": "rows",
  "submissionStatus": "UNSUBMITTED",
  "versionMetadata": {
    "__typename": "__typename",
    "createdAt": "createdAt",
    "versionId": "versionId"
  }
}
```

**SDK Code**

```python
import requests

url = "https://{tenant_name}.benchling.com/api/v3/document-part-results-table/document_part_results_table_id"

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-results-table/document_part_results_table_id';
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);
}
```