Skip to main content
GET
/
buckets
/
{id}
/
objects
List bucket objects
curl --request GET \
  --url https://nulldrop.xyz/api/v2/buckets/{id}/objects \
  --header 'Authorization: Bearer <token>'
{
  "objects": [
    {
      "id": "<string>",
      "filename": "<string>",
      "originalName": "<string>",
      "size": 123,
      "mimeType": "<string>",
      "downloadUrl": "<string>",
      "shareUrl": "<string>",
      "isPublic": true,
      "downloadCount": 123,
      "uploadedAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "expiresAt": "2023-11-07T05:31:56Z"
    }
  ],
  "commonPrefixes": [
    "<string>"
  ],
  "nextCursor": "<string>",
  "prefix": "<string>"
}
The List Objects operation returns some or all (up to 100) of the objects in a bucket. You can use the prefix parameter to group objects into virtual folders.

​
Folder Simulation

Null Drop uses the / character to simulate folders. When you provide a prefix, the API:
  1. Filters objects whose keys start with that prefix.
  2. Identifies “Common Prefixes” (folders) at the current level.
  3. Returns files that are directly under that prefix.

​
Pagination

If the number of objects exceeds the limit, the response will include a nextCursor. To fetch the next page, send another request with the cursor parameter set to the value of nextCursor.

​
Sorting

By default, objects are sorted by Upload Date (Newest First). This behavior is consistent across the web interface and the API.

Authorizations

​
Authorization
string
header
required

API key authentication (format: nd_xxxxx)

Path Parameters

​
id
string
required

Bucket ID

Query Parameters

​
prefix
string

Filter by key prefix (folder)

​
cursor
string

Pagination cursor

​
limit
integer
default:50

Max items to return

Response

200 - application/json

Object list with common prefixes and cursor

​
objects
object[]
​
commonPrefixes
string[]
​
nextCursor
string | null
​
prefix
string