Skip to main content
GET
/
api
/
files
/
{id}
Get File
curl --request GET \
  --url https://api.example.com/api/files/{id} \
  --header 'Authorization: <authorization>'
{
  "data": {
    "file": {
      "id": 1,
      "project_id": 4,
      "name": "checkout-flow.docx",
      "url": "https://...r2.cloudflarestorage.com/project-resources/...?X-Amz-...",
      "description": null,
      "mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "size_bytes": 245000,
      "status": "uploaded",
      "created_by": "user-id",
      "created_at": "2026-03-20T10:30:00Z",
      "updated_at": "2026-03-20T10:30:00Z"
    }
  }
}
Returns a single file with a signed download URL that expires in 1 hour.

​
Request

​
Authorization
string
required
Bearer token for authentication. Format: Bearer <your-api-key>
​
id
number
required
The file ID.

​
Response

​
data.file
object
The file object.
{
  "data": {
    "file": {
      "id": 1,
      "project_id": 4,
      "name": "checkout-flow.docx",
      "url": "https://...r2.cloudflarestorage.com/project-resources/...?X-Amz-...",
      "description": null,
      "mime_type": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
      "size_bytes": 245000,
      "status": "uploaded",
      "created_by": "user-id",
      "created_at": "2026-03-20T10:30:00Z",
      "updated_at": "2026-03-20T10:30:00Z"
    }
  }
}

​
Example

curl -X GET \
  https://dash.empirical.run/api/files/1 \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY"