API Documentation
Complete reference for the avfile.io REST API. Upload, manage, and share files programmatically.
Quick Navigation
Authentication
API key management and authentication endpoints
Authorization Header
Pass your API key via the Authorization header for authenticated endpoints. Format: Authorization: Bearer avf_your_api_key_here
Authorization: Bearer avf_your_api_key_hereFile Upload
Chunk-based file upload workflow
File Download & Info
Retrieve file information, download, and preview
Batch Operations
Group files into batches and perform bulk operations
User & MyPage
User info, plan details, and storage management
Folders
Organize files into folders
Utility
Configuration, analytics, QR codes, and geolocation
Rate Limits
The following limits apply to all API usage:
General Requests
No hard rate limit on general API requests. Fair use policy applies.
Upload Rate
No upload-per-hour limit on the free plan. Fair use expected.
Storage Limit
100 GB per IP address.
Max File Size
5 GB per file.
Batch Size
Maximum 50 files per batch. Maximum 100 files per batch operation.
Error Codes
The API uses standard HTTP status codes. Common errors include:
| Code | Status | Description |
|---|---|---|
| 200 | OK | Request succeeded |
| 201 | Created | Resource created successfully |
| 400 | Bad Request | Missing or invalid parameters |
| 401 | Unauthorized | Missing or invalid API key / Bearer token |
| 403 | Forbidden | You do not have permission to access this resource |
| 404 | Not Found | File, batch, or folder not found |
| 410 | Gone | File has expired or been deleted |
| 413 | Payload Too Large | File size exceeds the 5GB limit |
| 500 | Internal Server Error | An unexpected error occurred on the server |
| 502 | Bad Gateway | Upstream service (e.g., QR API) failed |
| 507 | Insufficient Storage | IP storage limit (100GB) exceeded |