FileShot API

REST API for secure file sharing. Available on Creator tier and above. Base URL: https://api.fileshot.io

Authentication

Include your API key in the Authorization header as a Bearer token. Generate keys from your Account Dashboard.

Authorization: Bearer <your_api_key>

Upload File Creator+

POST/api/files/upload

Upload a complete file (for files under 100MB). Returns file metadata and download URL.

Param	Type	Required	Description
`file`	binary	Yes	The file to upload
`customSlug`	string	No	Custom URL slug (e.g. "my-project")
`passwordProtected`	boolean	No	Enable AES-256-GCM password encryption
`expiryDays`	integer	No	Days until expiry (1-365). Free max: 90.
`enablePaidAccess`	boolean	No	Require payment to download
`price`	number	No	Download price in USD cents (min 100)

# cURL curl -X POST https://api.fileshot.io/api/files/upload \\ -H "Authorization: Bearer <token>" \\ -F "file=@document.pdf" \\ -F "customSlug=my-doc" \\ -F "expiryDays=30" # Response { "success": true, "fileId": "abc123...", "downloadUrl": "https://fileshot.io/f/abc123...", "expiresAt": "2026-06-25T12:00:00Z", "fileSize": 1048576 }

Upload Chunk Creator+

POST/api/files/upload-chunk/:fileId/:chunkIndex

Upload a chunk for resumable/large file uploads. First call /api/files/init-upload to get a fileId.

# cURL curl -X POST https://api.fileshot.io/api/files/upload-chunk/FILE_ID/0 \\ -H "Authorization: Bearer <token>" \\ -H "Content-Type: application/octet-stream" \\ --data-binary @chunk0.bin

Get File Info

GET/api/files/:fileId

Retrieve metadata for a file. No auth required for public files.

curl https://api.fileshot.io/api/files/abc123... # Response { "fileId": "abc123...", "fileName": "document.pdf", "fileSize": 1048576, "mimeType": "application/pdf", "expiresAt": "2026-06-25T12:00:00Z", "isZeroKnowledge": false, "passwordProtected": false }

Download File

GET/api/files/download/:fileId

Redirect to the actual file download URL. Returns 302 to CDN or direct stream.

Delete File Creator+

DELETE/api/files/:fileId

Permanently delete a file and all associated data. Requires ownership.

List My Files Creator+

GET/api/files

List files uploaded by the authenticated user. Supports pagination.

Query	Type	Description
`page`	integer	Page number (default: 1)
`limit`	integer	Items per page (default: 20, max: 100)

Error Codes

Code	Meaning
`400`	Bad Request — invalid parameters or missing required fields
`401`	Unauthorized — invalid or missing API key
`403`	Forbidden — valid key but insufficient tier (Creator+ required)
`404`	Not Found — file does not exist or has expired
`413`	Payload Too Large — file exceeds tier limit
`429`	Too Many Requests — rate limit exceeded
`503`	Service Unavailable — temporary backend issue

Rate Limits

Tier	Upload	API Calls	Max File Size
Free	10/hour	N/A	10 GB
Pro	100/hour	N/A	100 GB
Creator	500/hour	1,000/min	300 GB
Professional	Unlimited	Unlimited	500 GB

Need higher limits? Upgrade your plan or contact us for enterprise pricing.