PushFTP/Docs

Download a file

Pull files from your server through PushFTP's fixed IP.

GET Endpoint

GET https://pushftp.com/api/download/{connectionId}?path=/reports/march.csv
pathrequiredFull remote file path to download

Example

curl -O https://pushftp.com/api/download/YOUR_CONNECTION_ID \
  -H "Authorization: Bearer pftp_your_key" \
  "?path=/exports/data.csv"

Response

Returns the file as a binary download with appropriate headers:

  • Content-Type — detected from file extension (csv, json, xml, pdf, etc.)
  • Content-Disposition — attachment; filename="data.csv"
  • X-Transfer-Id — unique transfer ID for logging
  • X-Duration-Ms — how long the download took

Error responses

  • 404 — File not found on the remote server
  • 401 — Authentication failed with the remote server
  • 403 — Permission denied reading the file
  • 502 — Cannot reach the remote server