---
title: "Get Object"
url: https://docs.catalyst.zoho.com/en/sdk/ios/v2/cloud-scale/stratus/get-object/
description: "This page lists the iOS SDK method to get an object or objects from the bucket."
last_updated: 2026-09-08T11:07:33Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus Component Help Documentation"
    url: /en/cloud-scale/help/stratus/introduction
  - name: "Java SDK"
    url: /en/sdk/java/v1/cloud-scale/stratus/get-objects/
  - name: "JavaScript SDK Documentation"
    url: /en/sdk/javascript/v1/overview/
  - name: "Python SDK"
    url: /en/sdk/python/v1/cloud-scale/stratus/get-objects/
  - name: "Android SDK"
    url: /en/sdk/android/v2/cloud-scale/stratus/get-object/
  - name: "Flutter SDK"
    url: /en/sdk/flutter/v1/cloud-scale/stratus/get-object/
  - name: "REST API"
    url: /en/api/code-reference/cloud-scale/stratus/get-all-objects/#GetAllObjects
---

# Get Object

This SDK method can be used to get an object from the bucket. The response will be in **blob** format. 

When [Versioning](https://docs.catalyst.zoho.com/en/cloud-scale/help/stratus/stratus-config/general-settings/#versioning) is enabled for the bucket:

* If you do not pass the `versionId`, then only the **latest object** will be returned.
* To retrieve a specific version, use the `versionId` query parameter with a valid version as a value.

**Parameters Used**

<table class="content-table">
	<thead>
		<tr>
			<th class="w30p">Parameter Name</th>
      <th class="w70p">Definition</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`objectKey`</td>
			<td>A **mandatory** parameter. Will contain the object name.</td>
		</tr>
		<tr>
			<td>`versionId`</td>
			<td>An **optional** parameter. Will hold the unique version ID of the required object's version.</td>
		</tr>
	</tbody>
</table>

```bash
bucketInstance.getObject( objectKey : "{object_name}", versionId : "{version_id}" ) { result in
	switch result {
		case .success( let object ) :
			print( "File Name : \( object.fileName )" )
		case .error(let error) :
			print("Error : \( error )")
	}
}
```

The required object will be returned.

**Possible Exception**

* **404**: Object or Bucket Not Found

### Get All Objects

This SDK method can be used to get all the objects present in the bucket using pagination technique.

**Parameters Used**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">Parameter Name</th>
			<th class="w20p">Data Type</th>
      <th class="w60p">Definition</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`prefix`</td>
			<td>**String**</td>
			<td>An **Optional** parameter. This will get the objects that match the prefix value.</td>
		</tr>
		<tr>
			<td>`maxKeys`</td>
			<td>**Number**</td>
			<td>An **Optional** parameter. Will contain the maximum limit of objects that can be listed by pagination.</td>
		</tr>
		<tr>
			<td>`continuation_token`</td>
			<td>**String**</td>
			<td>An **Optional** parameter. If the response was truncated, the value of this key must be passed as `continuation_token` to the same method for retrieving the next set of objects.</td>
		</tr>
	</tbody>
</table>

```bash
var params = ZCatalystQuery.ObjectParams()
params.maxKeys = 10
params.continuationToken = "{continuation_token}"
parmas.prefix = "{prefix}"
bucketInstance.getObjects( withParams : params ) { result in
	switch result {
		case .success( let objects, let response ) :
			for object in objects {
				print("File Name : \( object.fileName  )")
			}
		case .error( let error ) :
			print("Error : \( error )")
	}
}
```

The required object will be returned as an array in Blob format.

**Possible Exception**

* **404**: Object or Bucket Not Found