---
title: "Get a Legacy Request by ID"
method: GET
path: "/requests/{request_id}"
tags: ["legacyRequests"]
---

# Get a Legacy Request by ID

`GET /requests/{request_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/requests/{request_id}`
- Auth: HTTP bearer

Get a Legacy Request by ID

## Path parameters

- `request_id` string, required

## Query parameters

- `returning` string

## Response `200`

OK

- Request: A Legacy Request is an ask to perform a service, e.g. produce a sample or perform assays on a sample. Requests are usually placed to another team or individual who specializes in performing the service.
  - `apiURL` string, uri: The canonical url of the Legacy Request in the API.
  - `assignees` RequestAssigneesItems[]: Array of assignees
    - union
      - RequestUserAssignee
        - `user` UserSummary
          - `handle` string
          - `id` string
          - `name` string
      - RequestTeamAssignee
        - `team` TeamSummary
          - `id` string
          - `name` string
  - `createdAt` string, isoformat: Date and time the Legacy Request was created
  - `creator` RequestCreator: UserSummary of the user who created the Legacy Request
    - `handle` string
    - `id` string
    - `name` string
  - `displayId` string: User-friendly ID of the Legacy Request
  - `fields` Fields
  - `id` string: Unique ID for the Legacy Request
  - `projectId` string: The ID of the project to which the Legacy Request belongs.
  - `requestStatus` 'REQUESTED' | 'SCHEDULED' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELLED'
  - `requestor` RequestRequestor: UserSummary of the user making the Legacy Request
    - `handle` string
    - `id` string
    - `name` string
  - `sampleGroups` RequestSampleGroup[]
    - `id` string
    - `samples` union
      - RequestSampleWithEntity
        - `containerId` string
        - `entityId` string, required
      - RequestSampleWithBatch
        - `batchId` string, required
        - `containerId` string
  - `scheduledOn` string, date, nullable: Date the Legacy Request is scheduled to be executed on, in YYYY-MM-DD format.
  - `schema` RequestSchema
    - `archiveRecord` ArchiveRecord
      - `reason` string
    - `fieldDefinitions` RequestSchemaFieldDefinitionsItems[]
      - union
        - SimpleFieldDefinition
          - `archiveRecord` ArchiveRecord
            - `reason` string
          - `id` string
          - `isMulti` boolean
          - `isRequired` boolean
          - `name` string
          - `type` 'dna_sequence_link' | 'aa_sequence_link' | 'custom_entity_link' | 'entity_link' | 'mixture_link' | 'molecule_link' | 'dropdown' | 'part_link' | 'translation_link' | 'aa_part_link' | 'base_molecule_link' | 'blob_link' | 'text' | 'long_text' | 'batch_link' | 'storage_link' | 'entry_link' | 'assay_request_link' | 'assay_result_link' | 'assay_run_link' | 'boolean' | 'float' | 'integer' | 'datetime' | 'date' | 'json'
        - IntegerFieldDefinition
          - `archiveRecord` ArchiveRecord
            - `reason` string
          - `id` string
          - `isMulti` boolean
          - `isRequired` boolean
          - `name` string
          - `type` 'dna_sequence_link' | 'aa_sequence_link' | 'custom_entity_link' | 'entity_link' | 'mixture_link' | 'molecule_link' | 'dropdown' | 'part_link' | 'translation_link' | 'aa_part_link' | 'base_molecule_link' | 'blob_link' | 'text' | 'long_text' | 'batch_link' | 'storage_link' | 'entry_link' | 'assay_request_link' | 'assay_result_link' | 'assay_run_link' | 'boolean' | 'float' | 'integer' | 'datetime' | 'date' | 'json'
          - `numericMax` number, double, nullable
          - `numericMin` number, double, nullable
          - `unit` UnitSummary
            - `id` string
            - `name` string
            - `symbol` string
            - `unitTypeId` string
        - FloatFieldDefinition
          - `archiveRecord` ArchiveRecord
            - `reason` string
          - `id` string
          - `isMulti` boolean
          - `isRequired` boolean
          - `name` string
          - `type` 'dna_sequence_link' | 'aa_sequence_link' | 'custom_entity_link' | 'entity_link' | 'mixture_link' | 'molecule_link' | 'dropdown' | 'part_link' | 'translation_link' | 'aa_part_link' | 'base_molecule_link' | 'blob_link' | 'text' | 'long_text' | 'batch_link' | 'storage_link' | 'entry_link' | 'assay_request_link' | 'assay_result_link' | 'assay_run_link' | 'boolean' | 'float' | 'integer' | 'datetime' | 'date' | 'json'
          - `decimalPrecision` number, double, nullable
          - `legalTextDropdownId` string, nullable
          - `numericMax` number, double, nullable
          - `numericMin` number, double, nullable
          - `unit` UnitSummary
            - `id` string
            - `name` string
            - `symbol` string
            - `unitTypeId` string
        - DropdownFieldDefinition
          - `archiveRecord` ArchiveRecord
            - `reason` string
          - `id` string
          - `isMulti` boolean
          - `isRequired` boolean
          - `name` string
          - `type` 'dna_sequence_link' | 'aa_sequence_link' | 'custom_entity_link' | 'entity_link' | 'mixture_link' | 'molecule_link' | 'dropdown' | 'part_link' | 'translation_link' | 'aa_part_link' | 'base_molecule_link' | 'blob_link' | 'text' | 'long_text' | 'batch_link' | 'storage_link' | 'entry_link' | 'assay_request_link' | 'assay_result_link' | 'assay_run_link' | 'boolean' | 'float' | 'integer' | 'datetime' | 'date' | 'json'
          - `dropdownId` string, nullable
        - SchemaLinkFieldDefinition
          - `archiveRecord` ArchiveRecord
            - `reason` string
          - `id` string
          - `isMulti` boolean
          - `isRequired` boolean
          - `name` string
          - `type` 'dna_sequence_link' | 'aa_sequence_link' | 'custom_entity_link' | 'entity_link' | 'mixture_link' | 'molecule_link' | 'dropdown' | 'part_link' | 'translation_link' | 'aa_part_link' | 'base_molecule_link' | 'blob_link' | 'text' | 'long_text' | 'batch_link' | 'storage_link' | 'entry_link' | 'assay_request_link' | 'assay_result_link' | 'assay_run_link' | 'boolean' | 'float' | 'integer' | 'datetime' | 'date' | 'json'
          - `schemaId` string, nullable
    - `id` string
    - `name` string
    - `type` 'request'
    - `modifiedAt` string, date-time: DateTime the Legacy Request Schema was last modified
    - `organization` RequestSchemaOrganization: The organization that owns the schema.
      - `handle` string
      - `id` string
      - `name` string
    - `systemName` string
  - `tasks` RequestTask[]
    - `fields` Fields
    - `sampleGroupIds` string[]: IDs of all Legacy Request Sample Groups now associated with this task.
    - `id` string, required: ID of the Legacy Request Task
    - `schema` SchemaSummary
      - `id` string
      - `name` string
  - `webURL` string, uri: URL of the Legacy Request

## Other responses

- `404`: Not Found

---

[API](https://skmtc.dev/benchling/apis/benchling-api-2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-2/revisions/01d2fa8523cd?raw)