---
title: "Get ProcedureMethodExecutionInstance by ID"
method: GET
path: "/api/v3/procedure-method-execution-instance/{procedure_method_execution_instance_id}"
tags: ["Procedure Method Execution Instance"]
---

# Get ProcedureMethodExecutionInstance by ID

`GET /api/v3/procedure-method-execution-instance/{procedure_method_execution_instance_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/procedure-method-execution-instance/{procedure_method_execution_instance_id}`
- Auth: HTTP bearer

Get a single ProcedureMethodExecutionInstance by ID.

## Path parameters

- `procedure_method_execution_instance_id` string, required

## Query parameters

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

## Headers

- `EARLY-ACCESS` string

## Response `200`

OK

- ProcedureMethodExecutionInstance: An instance of a method being executed within a procedure run. When a scientist runs a procedure, each method in the flowchart becomes a ProcedureMethodExecutionInstance that tracks the actual execution: the worksheet where data is entered (`worksheet`), the associated task (`methodTask`), step groups with execution instances (`stepGroups`), and all parameter values (planned, confirmed, and measured). Links to its `ProcedureRun`, the template method it's based on (`templateMethodVersion`), and the specific condition/replicate it belongs to (`procedureRunConditionReplicate`). Material flow between methods is tracked via `sourceProcedureMethodExecutionInstanceAssociations` and `targetProcedureMethodExecutionInstanceAssociations`. ## Product mapping - In the Benchling UI, this maps to a **condition-replicate-specific execution of a unit operation** within an active experiment. - Think of this as the runtime counterpart to `ProcedureMethodDefinitionVersion`: - `ProcedureMethodDefinitionVersion` = template/config definition - `ProcedureMethodExecutionInstance` = run-time execution record
  - `__typename` string
  - `archiveReason` string, nullable
  - `archived` boolean
  - `createdAt` string, datetime
  - `createdRetestOrders` string, uri: The retest orders that were created when the assay run for this PMEI was approved. Used on assay run retraction to identify the retest orders to cancel.
  - `dataParameterActualValues` string, uri
  - `dataParameterConfirmationValues` string, uri
  - `dataParameterPlannedValues` string, uri: Source of truth for this specific PMEI's planned data parameter values, with any condition overrides.
  - `equipmentConfirmationValues` string, uri
  - `equipmentPlannedValues` string, uri: Source of truth for this specific PMEI's planned equipment values, with any condition overrides.
  - `id` string
  - `materialInputConfirmationValues` string, uri
  - `materialInputPlannedValues` string, uri: Source of truth for this specific PMEI's planned material input values, with any condition overrides. Note: This will not include any process intermediate values when previous methods have not yet been completed.
  - `materialOutputConfirmationValues` string, uri
  - `modifiedAt` string, datetime
  - `procedureRun` ProcedureRunRef
    - `__typename` string
    - `id` string, api_id
  - `procedureRunConditionReplicate` ProcedureRunConditionReplicateRef
    - `__typename` string
    - `id` string, api_id
  - `stepGroups` ProcedureExecutionStepGroup[]
    - `__typename` string
    - `group` 'PRE_RUN' | 'RUN' | 'POST_RUN'
    - `steps` ProcedureStepExecutionInstanceRef[]
      - `__typename` string
      - `id` string, api_id
  - `taskTransitionExtensions` TaskTransitionExtension[]
    - `__typename` string
    - `comment` string
    - `statusDisplayName` string
    - `timestampUtcIsoformat` string
  - `templateMethodVersion` ProcedureMethodDefinitionVersionRef
    - `__typename` string
    - `id` string, api_id
  - `testOrders` string, uri: The test orders that were plated in this PMEI's worksheet.

## 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/3873a10bf7b8?raw)