---
title: "Read upload and verification progress"
method: GET
path: "/v1/research-workspaces/{id}/transfers/{transfer}"
tags: ["Research workspaces"]
---

# Read upload and verification progress

`GET /v1/research-workspaces/{id}/transfers/{transfer}`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/research-workspaces/{id}/transfers/{transfer}`
- Auth: HTTP bearer

Read state and uploaded_segments before resuming an interrupted upload. A committed transfer has replaced the guarded saved-file revision. Queued or verifying does not establish a successful save. Requires stopped compute and the active workspace storage policy.

## Path parameters

- `id` string, required
- `transfer` string, uuid, required

## Response `200`

Current transfer state

- WorkspaceTransfer
  - `id` string, uuid, required
  - `workspace_id` string, required
  - `failure_code` string: Recorded verification failure when present. Inspect state before retrying or beginning a replacement transfer.
  - `state` 'uploading' | 'queued' | 'verifying' | 'committed' | 'abandoned', required
  - `base_revision` integer, required
  - `manifest_sha256` string, required
  - `manifest_bytes` integer, required
  - `uploaded_segments` integer[], required: Zero-based indexes already verified for this transfer. Empty when no segment is present.

## Other responses

- `default`: 400 for malformed input. 404 workspace_transfer_not_found for a missing or inaccessible transfer. 409 workspace_storage_inactive when the policy is disabled, or workspace_transfer_conflict when state, revision or retry identity changed. 413 workspace_storage_capacity when capacity is exhausted. 503 workspace_transfer_unavailable or workspace_storage_unavailable for transient failures. Authentication and rate limits apply.

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)