---
title: "Get ProcedureRunPlan by ID"
method: GET
path: "/api/v3/procedure-run-plan/{procedure_run_plan_id}"
tags: ["Procedure Run Plan"]
---

# Get ProcedureRunPlan by ID

`GET /api/v3/procedure-run-plan/{procedure_run_plan_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/procedure-run-plan/{procedure_run_plan_id}`
- Auth: HTTP bearer

Get a single ProcedureRunPlan by ID.

## Path parameters

- `procedure_run_plan_id` string, required

## Query parameters

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

## Headers

- `EARLY-ACCESS` string

## Response `200`

OK

- ProcedureRunPlan: A draft experiment plan that can be promoted to a `ProcedureRun` for execution. Scientists use run plans to configure experimental conditions, parameter values, and replicates before starting an actual experiment. Belongs to a `Study` and exposes its Workflows-backed procedure template through `procedureFlowchartConfigVersion`. Contains `ProcedureRunPlanCondition` objects that define the different experimental configurations to test. The `dataEntryMode` (see `ProcedureRunDataEntryMode`) specifies whether each condition-replicate will have its own data entry worksheet or share a single worksheet. The `confirmationMethodByParamVersionId` allows overriding default confirmation methods for specific parameters. Upon promotion, the run plan becomes a `ProcedureRun` with corresponding `ProcedureRunCondition` and `ProcedureRunConditionReplicate` objects. Also known as a "draft experiment" in the Benchling UI. ## Product mapping - `ProcedureRunPlan` is the API model for the **draft procedure run** setup object in the UI. - Promoting a run plan creates the executable `ProcedureRun` and carries forward its condition/replicate setup.
  - `__typename` string
  - `confirmationMethodByParamVersionId` ConfirmationMethodByParamVersionId[]
    - `__typename` string
    - `confirmationMethod` 'TABLE' | 'PLATE_MAP'
    - `paramVersionId` string
  - `createdAt` string, datetime
  - `creator` PrincipalRef
    - `__typename` string
    - `id` string, api_id
  - `dataEntryMode` 'INDIVIDUAL_CONDITION_REPLICATES' | 'ALL_CONDITION_REPLICATES_TOGETHER'
  - `description` string
  - `id` string
  - `modifiedAt` string, datetime
  - `procedureFlowchartConfigVersion` ProcedureFlowchartConfigVersionRef
    - `__typename` string
    - `id` string, api_id
  - `procedureRun` ProcedureRunRef
    - `__typename` string
    - `id` string, api_id
  - `procedureRunPlanConditions` string, uri
  - `study` StudyRef
    - `__typename` string
    - `id` string, api_id

## 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)