Skip to main content
GET
/
api
/
resources
List Resources
curl --request GET \
  --url https://dash.empirical.run/api/resources \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "resources": [
      {
        "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"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 1,
    "total_pages": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.empirical.run/llms.txt

Use this file to discover all available pages before exploring further.

Returns a paginated list of uploaded resources for a project. Each resource includes a signed download URL that expires in 1 hour. Only resources with uploaded status are returned. 
{
  "data": {
    "resources": [
      {
        "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"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 1,
    "total_pages": 1
  }
}

​
Example

curl -X GET \
  "https://dash.empirical.run/api/resources?page=1&per_page=20" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY"

Authorizations

​
Authorization
string
header
required

Project API key from the Empirical dashboard.

Query Parameters

​
page
number

Page number (1-indexed, default 1).

​
per_page
number

Items per page (default 20, max 100).

Response

Paginated list of resources.

​
data
object
required
​
pagination
object
required