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

# Get ProcedureRunPlanCondition by ID

`GET /api/v3/procedure-run-plan-condition/{procedure_run_plan_condition_id}`

## Request

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

Get a single ProcedureRunPlanCondition by ID.

## Path parameters

- `procedure_run_plan_condition_id` string, required

## Query parameters

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

## Headers

- `EARLY-ACCESS` string

## Response `200`

OK

- ProcedureRunPlanCondition: A planned experimental condition within a `ProcedureRunPlan`, representing how a procedure's methods will be configured when the plan is promoted to an actual `ProcedureRun`. Each condition contains pre-filled parameter values (via `MethodParametersPlan`) for the procedure's unit operations, and specifies how many replicates will be run (via `ProcedureRunPlanConditionReplicate`). Scientists use conditions to plan different experimental configurations before execution—for example, testing multiple temperatures or reagent concentrations. The `position` field determines display order within the parent run plan. Upon promotion, each ProcedureRunPlanCondition becomes a `ProcedureRunCondition` in the resulting experiment. Also known as an "experiment condition" in the Benchling UI's experiment planning workflow.
  - `__typename` string
  - `createdAt` string, datetime
  - `description` string: The user-defined description of the condition.
  - `id` string
  - `methodParametersPlan` MethodParametersPlan: Contains the planned parameter values for a single unit operation (method) within a `ProcedureRunPlanCondition`. Links to a `ProcedureMethodDefinitionVersion` via `templateMethodVersion` to identify which method these values apply to. Parameter values are organized by category: `dataParameterValues` for data fields like numbers or text, `materialInputValues` for sample or reagent inputs, and `equipmentValues` for equipment assignments. When the parent `ProcedureRunPlan` is promoted to a `ProcedureRun`, these planned values become the starting values in the resulting `ProcedureMethodExecutionInstance`.
    - `__typename` string
    - `dataParameterValues` DataParameterValuePlan[]: Planned values for data parameters keyed by parameter identifiers.
      - `__typename` string
      - `parameterId` string
      - `value` DataParameterValuePlanValue
    - `equipmentValues` EquipmentValuePlan[]: Planned values for equipment keyed by equipment identifiers.
      - `__typename` string
      - `equipmentId` string
      - `value` EquipmentValuePlanValue
    - `materialInputValues` MaterialInputValuePlan[]: Planned values for material inputs keyed by input identifiers.
      - `__typename` string
      - `materialInputId` string
      - `value` MaterialInputValuePlanValue
  - `modifiedAt` string, datetime
  - `name` string: The user-defined name of the condition.
  - `position` integer: The display order of the condition within the run.
  - `procedureRunPlan` ProcedureRunPlanRef
    - `__typename` string
    - `id` string, api_id
  - `replicates` ProcedureRunPlanConditionReplicate[]: Replicate information for this condition.
    - `__typename` string
    - `procedureRunPlanCondition` ProcedureRunPlanConditionRef
      - `__typename` string
      - `id` string, api_id
    - `replicateNumber` integer: The replicate number.
    - `sourcePmeiIds` string[]: Source PMEI IDs for this replicate. Support unit operation linking to future-pmeis when executing the draft procedure run.
  - `templateMethodVersion` ProcedureMethodDefinitionVersionRef
    - `__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)