Retrieve a file

Get a signed download URL for a file.

Endpoint

GET https://api.beecargo.net/files/download/[fileId]

Authentication

No authentication required. Anyone with the file ID can download the file.

Request examples

Retrieve a signed download URL by providing the file ID. The URL expires in 1 hour.

# Get download URL

curl https://api.beecargo.net/files/download/550e8400-e29b-41d4-a716-446655440000

# Download file directly

curl -L https://api.beecargo.net/files/download/550e8400-e29b-41d4-a716-446655440000 \
  -o downloaded-file.pdf

Parameters

Parameter	Type	Required	Description
fileId	String (UUID)	Yes	The unique identifier of the file

Response

Returns a signed download URL that expires in 1 hour (3600 seconds).

{
  "success": true,
  "data": {
    "url": "https://signed-url.cloudflare.com/...",
    "fileName": "document.pdf",
    "size": 1048576,
    "mimeType": "application/pdf",
    "expiresIn": 3600,
    "expiresAt": null,
    "downloads": 42,
    "canDelete": false,
    "shortId": "abc123"
  }
}

Error response

{
  "success": false,
  "error": "File not found"
}

Usage notes

The signed URL expires in 1 hour (3600 seconds)
Each request to this endpoint counts as a download
The actual file is downloaded from the signed URL, not this endpoint
Downloads are tracked for analytics purposes