---
title: "Get Chart by ID"
method: GET
path: "/api/v3/chart/{chart_id}"
tags: ["Chart"]
---

# Get Chart by ID

`GET /api/v3/chart/{chart_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/chart/{chart_id}`
- Auth: HTTP bearer

Get a single Chart by ID.

## Path parameters

- `chart_id` string, required

## Query parameters

- `returning` string[]
- `omit` string[]

## Headers

- `EARLY-ACCESS` string

## Response `200`

OK

- Chart: A Chart is a data visualization within Benchling. Charts store their configuration as a JSON object (see `libraryConfig`) compatible with a specific charting library (currently Plotly). A rasterized image is stored for archival purposes. Charts can optionally reference the automation step or AI chat session they originated from as provenance links.
  - `__typename` string
  - `archiveReason` string, nullable
  - `archived` boolean
  - `createdAt` string, datetime
  - `creator` PrincipalRef
    - `__typename` string
    - `id` string, api_id
  - `id` string
  - `library` 'PLOTLY'
  - `libraryConfig` ChartLibraryConfig: JSON object representing the direct input to a chart library on the front-end.
  - `libraryVersion` string: Version of the library that the config corresponds to. For example, if the library uses semver, we might store "1.2.3", "1.2.3-alpha.1", ect.
  - `modifiedAt` string, datetime
  - `name` string
  - `originAutomationStep` AutomationStepRef
    - `__typename` string
    - `id` string, api_id
  - `originAutomationStepDataName` string, nullable: The name of the data in originAutomationStep that this chart was created from.
  - `originPipelineStep` AutomationStepRef
    - `__typename` string
    - `id` string, api_id
  - `originPipelineStepDataName` string, nullable: The name of the data in originAutomationStep that this chart was created from.
  - `rasterConfig` ChartRasterConfig: Config used to generate the rasterized image of the chart in relation to th library that we're using. For example, in Plotly, this could be: ``` { width: 600 height: 400 scale: 0.5 format: "png" engine: "kaleido" } ```
  - `rasterDownloadUrl` string: URL to download a rasterized image of the chart. We store these images in perpetuity in case the library and libraryConfig version of the chart can no longer be rendered.
  - `rasterExternalFileId` string

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/benchling/apis/benchling-api.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api/revisions/c9f087b98b8b?raw)