Skip to main content
GET
/
buckets
/
{id}
/
objects
/
{key}
Download object
curl --request GET \
  --url https://nulldrop.xyz/api/v2/buckets/{id}/objects/{key} \
  --header 'Authorization: Bearer <token>'
"<string>"
The Download operation retrieves the content of an object. You can use it to fetch any file stored in your bucket.

​
URL-Encoding the Key

If your object’s key contains slashes or special characters, you must URL-encode the key in the path. Example:
  • Key: backups/db.sql
  • URL Path: /api/buckets/{id}/objects/backups%2Fdb.sql

​
Response Headers

The response includes the following headers to help your browser or client handle the file:
  • Content-Type: Automatically detected MIME type.
  • Content-Length: The file size in bytes.
  • Content-Disposition: Suggested filename for saving.
  • Cache-Control: Public cache settings.

Authorizations

​
Authorization
string
header
required

API key authentication (format: nd_xxxxx)

Path Parameters

​
id
string
required

Bucket ID

​
key
string
required

Object key (URL encoded)

Response

200 - */*

File content

The response is of type file.