---
title: "Get ProcedureStepDefinitionVersion by ID"
method: GET
path: "/api/v3/procedure-step-definition-version/{procedure_step_definition_version_id}"
tags: ["Procedure Step Definition Version"]
---

# Get ProcedureStepDefinitionVersion by ID

`GET /api/v3/procedure-step-definition-version/{procedure_step_definition_version_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/procedure-step-definition-version/{procedure_step_definition_version_id}`
- Auth: HTTP bearer

Get a single ProcedureStepDefinitionVersion by ID.

## Path parameters

- `procedure_step_definition_version_id` string, required

## Query parameters

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

## Headers

- `EARLY-ACCESS` string

## Response `200`

OK

- ProcedureStepDefinitionVersion: A versioned definition of a procedure step within a procedure flowchart. Steps represent documentation or instructions that guide scientists through a procedure but do not collect data—they differ from methods (`ProcedureMethodDefinitionVersion`) which have parameters for data entry. The `documentVersion` field links to a `DocumentVersion` containing the step's text content, which may include formatted instructions, images, or other rich content. Steps are immutable; updating a step creates a new version. Belongs to a procedure flowchart via `procedureFlowchartId`. Also known as a "text step" or "instruction step" in the Benchling UI. ## Product mapping - In the procedure editor, this maps to a **step** in a method template. The step typically contains instructions or operations to be performed during an experiment. - This is a template/versioned definition; the runtime record during execution is `ProcedureStepExecutionInstance`.
  - `__typename` string
  - `createdAt` string, datetime
  - `id` string
  - `name` 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)