---
title: "Get ProcedureParameterVersion by ID"
method: GET
path: "/api/v3/procedure-parameter-version/{procedure_parameter_version_id}"
tags: ["Procedure Parameter Version"]
---

# Get ProcedureParameterVersion by ID

`GET /api/v3/procedure-parameter-version/{procedure_parameter_version_id}`

## Request

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

Get a single ProcedureParameterVersion by ID.

## Path parameters

- `procedure_parameter_version_id` string, required

## Query parameters

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

## Headers

- `EARLY-ACCESS` string

## Response `200`

OK

- ProcedureParameterVersion: A versioned definition of a procedure parameter. Each version specifies the parameter's name, description, data type configuration (`dataType`), and how values are entered (`confirmationMethod`). Parameters are versioned to allow procedure templates to evolve while preserving the exact configuration used in past executions. Links to its parent `ProcedureParameter` for identity. For data parameters, `minimum` and `maximum` fields define optional numeric bounds. For material inputs, `amountDataType` configures how quantities are specified. For equipment parameters, `allowedEquipmentModels` restricts which equipment can be selected. May reference a `LibraryParameterDefinition` when the parameter was created from the parameter library.
  - `__typename` string
  - `allowedEquipmentModels` ProcedureParameterVersionAllowedEquipmentModels
  - `amountDataType` ProcedureParameterDataType: Specifies the value type configuration for a procedure parameter. Used within `ProcedureParameterVersion` to define what kind of data a parameter accepts. The `type` field indicates the field type (such as text, decimal, entity link, or dropdown). For numeric types, `unit` optionally references a `Unit` for measurement context. For entity link types, `schema` optionally constrains values to entities of a specific `EntitySchema`. Also used as `amountDataType` on material input parameter versions to define how amounts are specified.
    - `__typename` string
    - `dropdown` DropdownRef
      - `__typename` string
      - `id` string, api_id
    - `schema` EntitySchemaRef
      - `__typename` string
      - `id` string, api_id
    - `type` string
    - `unit` UnitRef
      - `__typename` string
      - `id` string, api_id
  - `confirmationMethod` 'TABLE' | 'PLATE_MAP'
  - `createdAt` string, datetime
  - `creator` PrincipalRef
    - `__typename` string
    - `id` string, api_id
  - `dataType` ProcedureParameterDataType: Specifies the value type configuration for a procedure parameter. Used within `ProcedureParameterVersion` to define what kind of data a parameter accepts. The `type` field indicates the field type (such as text, decimal, entity link, or dropdown). For numeric types, `unit` optionally references a `Unit` for measurement context. For entity link types, `schema` optionally constrains values to entities of a specific `EntitySchema`. Also used as `amountDataType` on material input parameter versions to define how amounts are specified.
    - `__typename` string
    - `dropdown` DropdownRef
      - `__typename` string
      - `id` string, api_id
    - `schema` EntitySchemaRef
      - `__typename` string
      - `id` string, api_id
    - `type` string
    - `unit` UnitRef
      - `__typename` string
      - `id` string, api_id
  - `description` string
  - `id` string
  - `maximum` ProcedureParameterVersionMaximum
  - `minimum` ProcedureParameterVersionMinimum
  - `name` string
  - `procedureParameter` ProcedureParameterRef
    - `__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)