> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# Gets upload requests within a workspace

GET https://api-d.docusign.com/v1/accounts/{accountId}/workspaces/{workspaceId}/upload-requests

This operation retrieves a list of upload requests within a workspace. Each upload request includes details such as ID, name, description, status, owner information, associated documents, assignments, and various dates.

[Required authentication scopes](/docs/workspaces-api/auth/): `dtr.rooms.read`

Reference: https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceuploadrequest/getworkspaceuploadrequests

## Authentication

- `Authorization` header (bearer token, required) — JWT Bearer token from Docusign authorization server

## Servers

- `https://api-d.docusign.com` (Demo, default)
- `https://api.docusign.com` (Production)

## Request

### Path parameters

- `accountId` (string, required) — The ID of the account
- `workspaceId` (string, required) — The ID of the workspace

## Response

### 200

Upload requests successfully retrieved

- `data` (list of WorkspaceUploadRequest, required, nullable) — The upload request list

## Errors

### 400 Bad Request Error

Bad request. See ErrorCode and Message for details

- `message` (string, optional, nullable) — A brief message describing the error condition
- `errorCode` (string, optional, nullable) — A standardized code that generalizes the specific error

### 401 Unauthorized Error

Not authorized to make this request

- `message` (string, optional, nullable) — A brief message describing the error condition
- `errorCode` (string, optional, nullable) — A standardized code that generalizes the specific error

### 500 Internal Server Error

Internal Server Error

- `message` (string, optional, nullable) — A brief message describing the error condition
- `errorCode` (string, optional, nullable) — A standardized code that generalizes the specific error

## Types

### WorkspaceUploadRequest

- `upload_request_id` (string, required) — The ID of the upload request
- `workspace_id` (string, required) — The ID of the workspace
- `name` (string, required, nullable) — The name of the upload request
- `upload_request_owner` (WorkspaceUploadRequestOwner, required)
- `status` (enum, required) — Enum representing the status of a workspace upload request
  - Allowed values: `draft`, `in_progress`, `overdue`, `complete`, `unknown`
- `documents` (list of WorkspaceUploadRequestDocument, required, nullable) — List of documents associated with the upload request
- `assignments` (list of WorkspaceUploadRequestAssignment, required, nullable) — List of user assignments for the upload request
- `created_date` (datetime, required, nullable) — The date the upload request was created
- `updated_date` (datetime, required, nullable) — The date the upload request was last updated
- `description` (string, optional, nullable) — The description of the upload request
- `due_date` (datetime, optional, nullable) — The due date for the upload request
- `sent_date` (datetime, optional, nullable) — The date the upload request was sent
- `completed_date` (datetime, optional, nullable) — The date the upload request was completed

### WorkspaceUploadRequestOwner

- `user_id` (string, required) — The ID of the upload request owner

### WorkspaceUploadRequestDocument

- `document_name` (string, optional, nullable) — The document name
- `document_id` (string, optional, nullable) — The document ID

### WorkspaceUploadRequestAssignment

- `assignee_user_id` (string, required) — The ID of the assigned user

## Examples

**Response**

```json
{
  "data": [
    {
      "upload_request_id": "8d7c6b5a-4f3e-2d1c-b9a8-7e6f5d4c3b2a",
      "workspace_id": "113e81b7-706e-4cab-9257-73b06325266e",
      "name": "Contract Documents Upload",
      "upload_request_owner": {
        "user_id": "211e2d22-f070-4c8d-b6a7-ecb14ceb81b4"
      },
      "status": "in_progress",
      "documents": [
        {
          "document_name": "Contract Agreement.pdf",
          "document_id": "9e2f4a8b-3c7d-4e5f-a1b2-8c9d6e3f4a7b"
        }
      ],
      "assignments": [
        {
          "assignee_user_id": "3b2c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e"
        }
      ],
      "created_date": "2025-09-01T12:00:00Z",
      "updated_date": "2025-09-01T12:00:00Z",
      "description": "Please upload the signed contract documents for review",
      "due_date": "2025-09-08T12:00:00Z",
      "sent_date": "2025-09-01T12:00:00Z",
      "completed_date": null
    },
    {
      "upload_request_id": "5a4b3c2d-1e9f-8a7b-6c5d-4e3f2a1b9c8d",
      "workspace_id": "113e81b7-706e-4cab-9257-73b06325266e",
      "name": "Employee Onboarding Documents",
      "upload_request_owner": {
        "user_id": "211e2d22-f070-4c8d-b6a7-ecb14ceb81b4"
      },
      "status": "complete",
      "documents": [],
      "assignments": [
        {
          "assignee_user_id": "4c3d5e6f-7a8b-9c0d-1e2f-3a4b5c6d7e8f"
        }
      ],
      "created_date": "2025-08-22T12:00:00Z",
      "updated_date": "2025-08-29T12:00:00Z",
      "description": "Upload required documents for new employee onboarding",
      "due_date": "2025-08-29T12:00:00Z",
      "sent_date": "2025-08-22T12:00:00Z",
      "completed_date": "2025-08-29T12:00:00Z"
    }
  ]
}
```