---
title: "Download Object"
url: https://docs.catalyst.zoho.com/en/api/code-reference/cloud-scale/stratus/download-object/
description: "This API enables you to perform download operations on an object stored in Stratus."
last_updated: 2026-08-28T06:26:16Z
service: Cloud Scale
type: api
---

# Download Object

### Description

This API allows you to download the required [object](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/objects/introduction/) stored in a bucket. The Bucket is referred by its [unique bucket name](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket), and the required object is referred using its name.

### Request Details

#### Request URL

`GET` {bucket_name}.zohostratus.com/{key}

The above domain name will change with respect to the data center:

<table class="content-table">
	<thead>
		<tr>
	        <th class="w20p">DC</th>
            <th class="w40p">Domain Name</th>
		</tr>
	</thead>
	<tbody>
        <tr>
            <td>`US`</td>
            <td>**zohostratus.com**</td>
        </tr>
        <tr>
            <td>`EU`</td>
            <td>**zohostratus.eu**</td>
        </tr>
         <tr>
            <td>`IN`</td>
            <td>**zohostratus.in**</td>
        </tr>
        <tr>
            <td>`AU`</td>
            <td>**zohostratus.com.au**</td>
        </tr>
        <tr>
            <td>`CA`</td>
            <td>**zohostratus.ca**</td>
        </tr>
        <tr>
            <td>`SA`</td>
            <td>**zohostratus.sa**</td>
        </tr>
        <tr>
            <td>`JP`</td>
            <td>**zohostratus.jp**</td>
        </tr>
	</tbody>
</table>

> **Note:** 

* If the API is used in the development environment, then the domain will be structured in this manner: https://<bucket_name>-development.zohostratus.com

* It is advisable to collect the bucket URL from the console.

#### Path Parameters

- **project_id** (Numerical): The [unique ID](https://docs.catalyst.zoho.com/en/getting-started/set-up-a-catalyst-project/general-settings/) of the project

- **bucket_name** (String): The [name of the bucket](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)

- **key** (String): The name of the object that needs to be downloaded

#### Query Parameters

- **version_id** (String, optional): This is an ID generated by Stratus when Versioning is enabled. You can use `version_id` to refer to the required object.

#### Request Headers
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**Optional Headers** 

 **Range:** To download a specific byte range of an object

 **retrieve-meta:** To retrieve the metadata of the object | Possible Values: `True/False` | Default Value: `False`

#### Scope

Stratus.fileop.READ

#### Query Params to Override Responses

The following query parameters can be added to modify responses and get the required response. These are all optional parameters. The override will only work if the request is successful.

- **responseContentType** (String, optional): Sets the `Content-Type` header of the response. Only standard [IANA defined](https://www.iana.org/assignments/media-types/media-types.xhtml) content types can be used.

- **responseContentLanguage** (String, optional): Sets the `Content-Language` header of the response

- **responseContentDisposition** (String, optional): Sets the `Content-Disposition` header of the response. The parameter value should be in this format:
 attachment; filename="name"
**Example:** attachment; filename="logo.svg"

- **responseCacheControl** (String, optional): Sets the `Cache-Control` header of the response.
**Example:** public,max-age=3600,no-transform

### Response Details

On successful execution, the response will contain the object will be downloaded and the success message will be displayed.

#### Possible Failure Responses

**404** due to object/bucket not found:

**Failure Response**

```json

    {
    "status": 404,
    "code": "key_not_found",
    "message": "no such key is associated with any object in the bucket"
    }

```

**403** Unauthorized. When you do not have the required permissions to perform the download operation

**Failure Response**

```json

    {
    "status": 403,
    "code": "access_forbidden",
    "message": "request denied by resource access policy"
    }

```

**Sample Request**

```bash

curl -X GET https://{bucket_name}.zohostratus.com/{key}
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"

```

**Sample Response**

```bash

200 OK
// Bytes of raw data

```

### SDK Documentation

* [Download Object - Java SDK](https://docs.catalyst.zoho.com/en/sdk/java/v1/cloud-scale/stratus/download-object/)
* [Download Object - Node.js SDK](https://docs.catalyst.zoho.com/en/sdk/nodejs/v2/cloud-scale/stratus/download-object/)
* [DownloadObject - Python SDK](https://docs.catalyst.zoho.com/en/sdk/python/v1/cloud-scale/stratus/download-object/)
* [Download - Web SDK](https://docs.catalyst.zoho.com/en/sdk/web/v4/cloud-scale/stratus/overview/)
* [Download - iOS SDK](https://docs.catalyst.zoho.com/en/sdk/ios/v2/cloud-scale/stratus/download-object/)
* [Download - Android SDK](https://docs.catalyst.zoho.com/en/sdk/android/v2/cloud-scale/stratus/download-object/)
* [Download - Flutter SDK](https://docs.catalyst.zoho.com/en/sdk/flutter/v2/cloud-scale/stratus/download-object/)