API Documentation - AnonFiles

Upload File

Send files with POST and receive a JSON response with the file URL.

Request JSON

curl -F "[email protected]" "https://api.anonfiles.ch/upload?key={YOUR_API_KEY}"

Request Pretty JSON

curl -F "[email protected]" "https://api.anonfiles.ch/upload?key={YOUR_API_KEY}&pretty"

Success Response

{
	"status": true,
	"data": {
		"file": {
			"url": {
				"full": "https://anonfiles.ch/nCzLKH5hQQL/test_txt",
				"short": "https://anonfiles.ch/s/nCzLKH5hQQL"
			},
			"metadata": {
				"id": "nCzLKH5hQQL",
				"name": "test.txt",
				"s_name": "test_txt",
				"size": {
					"bytes": 9,
					"readable": "9 B"
				},
				"type": "text/plain",
				"extension": ".txt",
				"created": "2025-04-07 10:13:07",
				"timestamp": 1744020787
			}
		}
	}
}

Error Codes

(10) ERROR_FILE_NOT_PROVIDED
(11) ERROR_FILE_EMPTY
(12) ERROR_FILE_INVALID
(13) ERROR_INVALID_KEY
(14) ERROR_INVALID_REQUEST
(15) ERROR_EMPTY_KEY
(20) ERROR_USER_MAX_FILES_PER_HOUR_REACHED
(21) ERROR_USER_MAX_FILES_PER_DAY_REACHED
(22) ERROR_USER_MAX_BYTES_PER_HOUR_REACHED
(23) ERROR_USER_MAX_BYTES_PER_DAY_REACHED
(30) ERROR_FILE_DISALLOWED_TYPE
(31) ERROR_FILE_SIZE_EXCEEDED
(32) ERROR_FILE_BANNED
(33) ERROR_FILE_NOT_FOUND
(40) STATUS_ERROR_SYSTEM_FAILURE

File Info

Get file information using the file ID.

Endpoint

https://api.anonfiles.ch/v3/file/{FILE_ID}/info

Example Request

https://api.anonfiles.ch/v3/file/nCzLKH5hQQL/info

Success Response

{
	"status": true,
	"data": {
		"file": {
			"url": {
				"full": "https://anonfiles.ch/nCzLKH5hQQL/test_txt",
				"short": "https://anonfiles.ch/s/nCzLKH5hQQL"
			},
			"metadata": {
				"id": "nCzLKH5hQQL",
				"name": "test.txt",
				"s_name": "test_txt",
				"size": {
					"bytes": 9,
					"readable": "9 B"
				},
				"type": "text/plain",
				"extension": ".txt",
				"created": "2025-04-07 10:13:07",
				"timestamp": 1744020787
			}
		}
	}
}

Error Response

{
	"status": false,
	"data": {
		"file": {
			"message": "The file you are looking for does not exist",
			"type": "ERROR_FILE_NOT_FOUND",
			"code": 33
		},
		"relay": {
			"tlbId": "875655a3-1f56-47fe-9b9d-3945552db99e",
			"timestamp": 1722966957189
		}
	}
}