---
title: "Get ProcedureStepExecutionInstance by ID"
method: GET
path: "/api/v3/procedure-step-execution-instance/{procedure_step_execution_instance_id}"
tags: ["Procedure Step Execution Instance"]
---

# Get ProcedureStepExecutionInstance by ID

`GET /api/v3/procedure-step-execution-instance/{procedure_step_execution_instance_id}`

## Request

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

Get a single ProcedureStepExecutionInstance by ID.

## Path parameters

- `procedure_step_execution_instance_id` string, required

## Query parameters

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

## Headers

- `EARLY-ACCESS` string

## Response `200`

OK

- ProcedureStepExecutionInstance: An execution instance of a procedure step within a `ProcedureMethodExecutionInstance`. Created when a procedure run is started, representing a step where scientists can document their work. The `document` field links to a `Document` (entry) where scientists write notes, observations, and results during execution. References both `planStepVersion` (from the run plan flowchart) and `templateStepVersion` (from the original procedure template) to track provenance—these are null for ad-hoc steps added during execution or auto-generated confirmation steps. The `stepTask` provides workflow orchestration via `WorkflowTask`. Can be archived along with its parent method execution instance through the `ArchivableWithLineage` lineage. Also known as a "step entry" or "execution step" in the Benchling UI. ## Product mapping - In the Benchling UI, this corresponds to the runtime **step entry** users complete within an active method execution. - This is the execution-time counterpart to `ProcedureStepDefinitionVersion` (template step definition).
  - `__typename` string
  - `archiveReason` string, nullable
  - `archived` boolean
  - `createdAt` string, datetime
  - `id` string
  - `methodExecutionInstance` ProcedureMethodExecutionInstanceRef
    - `__typename` string
    - `id` string, api_id
  - `modifiedAt` string, datetime
  - `name` string
  - `templateStepVersion` ProcedureStepDefinitionVersionRef
    - `__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)