> 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 details for a specific upload request

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

This operation retrieves details about a specific upload request within a workspace. The response includes comprehensive information about the upload request including status, assigned users, associated documents, owner details, and various dates.

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

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

## 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
- `uploadRequestId` (string, required) — The ID of the upload request

## Response

### 200

Upload request details successfully retrieved

- `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

## 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

### 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
{
  "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
}
```