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

Documentation Index

Fetch the complete documentation index at: https://docs.nulldrop.xyz/llms.txt

Use this file to discover all available pages before exploring further.

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.