PushFTP

List files in a folder

Get a directory listing with file names, sizes, types, and modification dates.

GET Endpoint

GET https://pushftp.com/api/list/{connectionId}?path=/uploads/

Example

curl https://pushftp.com/api/list/YOUR_CONNECTION_ID?path=/uploads/ \
  -H "Authorization: Bearer pftp_your_key"

Log in to see your real API key and connection IDs here.

pathoptionalDirectory path (defaults to connection's default path)

Response

{
  "path": "/uploads/",
  "files": [
    {
      "name": "report.csv",
      "path": "/uploads/report.csv",
      "size": 15234,
      "modifiedAt": "2026-03-28T14:30:00.000Z",
      "isDirectory": false
    },
    {
      "name": "archive",
      "path": "/uploads/archive",
      "size": 4096,
      "modifiedAt": "2026-03-25T09:00:00.000Z",
      "isDirectory": true
    }
  ]
}

Notes

  • Returns both files and subdirectories. Use isDirectory to filter.
  • Counts as 1 action toward your monthly limit.