Skip to main content

​
1) Create an API key

  1. Go to Manage → API Keys in the app
  2. Click “Create key” and copy the value (treat as secret)

​
2) Upload a file (cURL)

curl -X POST \
  -H "Authorization: Bearer <API_KEY>" \
  -F "file=@/path/to/file.png" \
  https://nulldrop.xyz/api/v1/upload
Response (201): 
{
  "success": true,
  "data": {
    "id": "file_123",
    "filename": "file.png",
    "size": 12345,
    "mimeType": "image/png",
    "downloadUrl": "https://nulldrop.xyz/api/v1/files/file_123/download",
    "shareUrl": "https://nulldrop.xyz/share/abc123",
    "uploadedAt": "2025-01-01T12:00:00.000Z"
  }
}

​
3) List your files (fetch)

await fetch('https://nulldrop.xyz/api/v1/files', {
  headers: { Authorization: `Bearer ${API_KEY}` }
}).then(r => r.json())

​
Tips

  • Rate limits are returned via headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
  • Common errors: NO_FILE, INVALID_FILE_TYPE, FILE_TOO_LARGE, STORAGE_LIMIT_EXCEEDED.
  • Base URL: https://nulldrop.xyz/api/v1

API Reference

Explore all endpoints and schemas.