Download file with extension:

curl -fSL https://lobfile.com/file/example.png -o example.png

Download file without extension:

curl -fSL https://lobfile.com/file/example -o example.png

Fetch SHA256 digest (returns plain text, not JSON):

curl -s https://lobfile.com/file/example.png.sha256

Upload a file:

curl -sS -X POST https://lobfile.com/api/v3/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/example.png"

Upload a file with SHA256 verification:

curl -sS -X POST https://lobfile.com/api/v3/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@/path/to/example.png" \
  -F "sha_256=YOUR_SHA256_DIGEST"

Example success JSON:

{
  "success": true,
  "url": "https://lobfile.com/image/example.png"
}

The path names the type for images, video, audio and text (/image/, /video/, /audio/, /text/). Everything else comes back as /file/, and the Typed Links setting turns this off.

Example error JSON:

{
  "success": false,
  "error": "Invalid API key"
}

Retrieve the account file list (defaults: upload_time desc, page 1, limit 200):

curl -sS -X GET "https://lobfile.com/api/v3/rest/get-file-list" \
  -H "X-API-Key: YOUR_API_KEY"

Retrieve the account file list (sort by name asc, page 2, limit 100):

curl -sS -X GET "https://lobfile.com/api/v3/rest/get-file-list?column=name&direction=asc&page=2&limit=100" \
  -H "X-API-Key: YOUR_API_KEY"

Example (truncated) success JSON:

{
  "success": true,
  "preferred_domain": "lobfile.com",
  "show_file_extensions": true,
  "return_typed_links": true,
  "sorting": {
    "column": "upload_time",
    "direction": "desc"
  },
  "pagination": {
    "page": 1,
    "limit": 200,
    "total_files": 2
  },
  "file_list": [
    {
      "name": "aB3dE7gH",
      "original_name": "screenshot",
      "extension": "png",
      "size": 184320,
      "content_type": "image/png",
      "link_type": "image",
      "hits": 42,
      "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "is_favorite": true,
      "time_added": "2026-09-19 14:02:11",
      "last_accessed": "2026-09-19 15:40:06"
    },
    {
      "name": "kL9mN2pQ",
      "original_name": "pack",
      "extension": "zip",
      "size": 5242880,
      "content_type": "application/zip",
      "link_type": "file",
      "hits": 3,
      "sha256": "2c26b46b68ffc68ff99b453c1d30413413422d706483bfa0f98a5e886266e7ae",
      "is_favorite": false,
      "time_added": "2026-09-18 09:15:44",
      "last_accessed": "2026-09-18 09:16:02"
    }
  ]
}

Example error (invalid key):

HTTP/1.1 401
{
  "success": false,
  "error": {
    "message": "Invalid API key.",
    "code": "AUTH_INVALID_KEY"
  }
}

Toggle a file as favorite:

curl -sS -X POST "https://lobfile.com/api/v3/rest/toggle-favorite" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file":"example"}'

Example success JSON:

{
  "success": true,
  "file_info": {
    "name": "example",
    "is_favorite": true
  }
}

Example error JSON (no such file):

HTTP/1.1 404
{
  "success": false,
  "error": {
    "message": "File not found or not updated.",
    "code": "FILE_NOT_FOUND"
  }
}

Delete a single file:

curl -sS -X DELETE "https://lobfile.com/api/v3/rest/delete-files" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "files": ["s1ID"] }'

Delete multiple files:

curl -sS -X DELETE "https://lobfile.com/api/v3/rest/delete-files" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "files": ["P9uRkgR8", "9qs7q67Q"] }'

Example success JSON:

{
  "success": true,
  "deleted": [
    "example"
  ]
}

Example invalid body (shows error shape):

HTTP/1.1 400
{
  "success": false,
  "error": {
    "message": "Invalid request body. Expected JSON object with 'files' array.",
    "code": "INVALID_INPUT"
  }
}

Fetch account info:

curl -sS -X GET "https://lobfile.com/api/v3/rest/get-account-info" \
  -H "X-API-Key: YOUR_API_KEY"

Example (truncated) success JSON:

{
  "success": true,
  "account": {
    "info": {
      "email": "you@example.com",
      "level": "PlanName",
      "api_key": "YOUR_API_KEY",
      "time_created": "2024-01-02 03:04:05"
    },
    "limits": {
      "space_quota": 1234,
      "slots_quota": 1234,
      "max_file_size": 1234,
      "max_file_download_speed": 1234,
      "max_bandwidth_monthly": 1234
    },
    "usage": {
      "space_used": 1233,
      "slots_used": 1233,
      "bandwidth_used_month": 1233
    }
  }
}

Fetch account settings:

curl -sS -X GET "https://lobfile.com/api/v3/rest/get-account-settings" \
  -H "X-API-Key: YOUR_API_KEY"

Example (truncated) success JSON:

{
  "success": true,
  "account": {
    "settings": {
      "preferred_domain": "lobfile.com",
      "return_file_extension": true,
      "return_typed_links": true,
      "continuous_uploading": false,
      "preferred_filename_length": 12,
      "inactivity_auto_delete_days": 30,
      "timezone_auto": true,
      "timezone": "America/Los_Angeles"
    }
  }
}