---
title: "Bulk get requests"
method: GET
path: "/requests:bulk-get"
tags: ["legacyRequests"]
---

# Bulk get requests

`GET /requests:bulk-get`

## Request

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

Bulk get Legacy Requests by API ID or display ID

## Query parameters

- `requestIds` string
- `displayIds` string
- `returning` string

## Response `200`

OK

- RequestsBulkGet
  - `requests` Request[]
    - `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
              - …
            - `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
              - …
            - `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
              - …
          - FloatFieldDefinition
            - `archiveRecord` ArchiveRecord
              - …
            - `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
              - …
          - DropdownFieldDefinition
            - `archiveRecord` ArchiveRecord
              - …
            - `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
              - …
            - `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

- `400`: Bad Request

---

[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)