Developers

UploadBay API

Manage your account, uploads, files and folders over HTTPS. Every request needs your API key.

Base URL https://uploadbay.co/api Get your API key

Account

GET/api/account/info

Account info

Email, balance, storage and Premium expiry.

curl "https://uploadbay.co/api/account/info?key=YOUR_API_KEY"
Example response
{
  "msg": "OK",
  "status": 200,
  "result": {
    "email": "[email protected]",
    "balance": "0.04900",
    "storage_used": null,
    "storage_left": "inf",
    "premium_expire": "2027-02-18 11:16:07"
  },
  "server_time": "2026-10-04 04:51:54"
}
GET/api/account/stats

Account stats

Downloads, views, sales and earnings.

curl "https://uploadbay.co/api/account/stats?key=YOUR_API_KEY"
Example response
{
  "msg": "OK",
  "status": 200,
  "result": [
    {
      "downloads": "0",
      "views": "0",
      "sales": "0",
      "refs": "0",
      "profit_sales": "0.00000",
      "profit_refs": "0.00000",
      "profit_site": "0.00000",
      "profit_total": "0.00000"
    }
  ],
  "server_time": "2026-10-04 04:55:33"
}

Upload

GET/api/upload/server

Get upload server

Step 1. Returns an upload URL and a session ID.

curl "https://uploadbay.co/api/upload/server?key=YOUR_API_KEY"
Example response
{
  "msg": "OK",
  "status": 200,
  "sess_id": "3rewps03u5ipbkm9",
  "result": "https://s1.uploadbay.co/cgi-bin/upload.cgi",
  "server_time": "2026-10-04 05:13:21"
}
POSTUPLOAD_URL

Upload a file

Step 2. Send the file to the upload URL from step 1.

curl -F "sess_id=SESS_ID" -F "utype=prem" -F "[email protected]" "UPLOAD_URL"
Example response
[
  {
    "file_code": "b578rni0e1ka",
    "file_status": "OK"
  }
]

File URL: https://uploadbay.co/b578rni0e1ka

GET/api/upload/url

Remote upload

Upload a file from a public URL.

curl "https://uploadbay.co/api/upload/url?key=YOUR_API_KEY&url=https://domain.com/file.zip&folder=0"
Example response
{
  "msg": "WORKING",
  "status": 200,
  "server_time": "2026-10-04 13:11:16"
}
GET/api/upload/url

Remote upload status

Check a remote upload by its file code.

curl "https://uploadbay.co/api/upload/url?key=YOUR_API_KEY&file_code=b578rni0e1ka"
Example response
{
  "status": 200,
  "file_code": "b578rni0e1ka"
}

Download

Files

GET/api/file/info

File info

Name, size, upload date and download count.

curl "https://uploadbay.co/api/file/info?file_code=b578rni0e1ka&key=YOUR_API_KEY"
Example response
{
  "msg": "OK",
  "status": 200,
  "result": [
    {
      "filecode": "b578rni0e1ka",
      "name": "file.zip",
      "status": 200,
      "size": 1048576,
      "uploaded": "2026-10-04 10:20:52",
      "downloads": 0
    }
  ],
  "server_time": "2026-10-04 10:23:03"
}
GET/api/file/list

List files

Optional filters: page, per_page, fld_id, public, created, name.

curl "https://uploadbay.co/api/file/list?page=1&per_page=20&fld_id=0&key=YOUR_API_KEY"
Example response
{
  "msg": "OK",
  "status": 200,
  "result": {
    "files": [
      {
        "name": "file.zip",
        "file_code": "b578rni0e1ka",
        "downloads": 0,
        "thumbnail": null,
        "public": 1,
        "size": 5789,
        "link": "https://uploadbay.co/b578rni0e1ka/file.zip.html",
        "fld_id": 0,
        "uploaded": "2026-10-04 10:20:52"
      }
    ],
    "results": 1,
    "results_total": 1
  }
}
GET/api/file/rename

Rename file

curl "https://uploadbay.co/api/file/rename?file_code=b578rni0e1ka&name=newname.zip&key=YOUR_API_KEY"
Example response
{
  "msg": "OK",
  "status": 200,
  "result": "true",
  "server_time": "2026-10-04 10:46:14"
}
GET/api/file/clone

Clone file

Create a copy of a file with a new file code.

curl "https://uploadbay.co/api/file/clone?file_code=b578rni0e1ka&key=YOUR_API_KEY"
Example response
{
  "msg": "OK",
  "status": 200,
  "result": {
    "url": "https://uploadbay.co/r9o25tsq86ru",
    "filecode": "r9o25tsq86ru"
  },
  "server_time": "2026-10-04 10:49:48"
}
GET/api/file/set_folder

Move to folder

curl "https://uploadbay.co/api/file/set_folder?file_code=b578rni0e1ka&fld_id=15&key=YOUR_API_KEY"
Example response
{
  "msg": "OK",
  "status": 200,
  "server_time": "2026-10-04 11:26:22"
}
GET/api/files/deleted

Deleted files

Files you deleted recently.

curl "https://uploadbay.co/api/files/deleted?key=YOUR_API_KEY"
Example response
{
  "msg": "OK",
  "status": 200,
  "result": [
    {
      "file_code": "ym7e86b6sap4",
      "name": "newname.zip",
      "deleted": "2026-10-04 11:41:58",
      "deleted_ago_sec": 4
    }
  ],
  "server_time": "2026-10-04 11:42:02"
}
POST/api/files/check

Check links

Check whether links exist and get their size. Send url_0, url_1 and so on.

curl "https://uploadbay.co/api/files/check" -F "key=YOUR_API_KEY" -F "url_0=https://uploadbay.co/b578rni0e1ka/file.zip"
Example response
{
  "msg": "OK",
  "status": 200,
  "result": {
    "https://uploadbay.co/b578rni0e1ka/file.zip": {
      "file_size": 127595568,
      "found": true
    }
  }
}

Folders

GET/api/folder/list

List folder

Files and subfolders inside a folder. Use fld_id=0 for the root.

curl "https://uploadbay.co/api/folder/list?fld_id=0&key=YOUR_API_KEY"
Example response
{
  "msg": "OK",
  "status": 200,
  "result": {
    "files": [
      {
        "fld_id": 0,
        "link": "https://uploadbay.co/b578rni0e1ka",
        "file_code": "b578rni0e1ka",
        "uploaded": "2026-10-04 10:49:51",
        "name": "file.zip"
      }
    ],
    "folders": [
      {
        "fld_id": 15,
        "code": null,
        "name": "folder1"
      }
    ]
  },
  "server_time": "2026-10-04 11:31:52"
}
GET/api/folder/create

Create folder

curl "https://uploadbay.co/api/folder/create?parent_id=0&name=newfolder&key=YOUR_API_KEY"
Example response
{
  "msg": "OK",
  "status": 200,
  "result": {
    "fld_id": 52
  },
  "server_time": "2026-10-04 11:37:35"
}
GET/api/folder/rename

Rename folder

curl "https://uploadbay.co/api/folder/rename?fld_id=15&name=newname&key=YOUR_API_KEY"
Example response
{
  "msg": "OK",
  "status": 200,
  "result": "true",
  "server_time": "2026-10-04 11:39:29"
}