Skip to main content
GET
/
api
/
test-runs
/
{id}
/
artifacts
List Artifacts
curl --request GET \
  --url https://dash.empirical.run/api/test-runs/{id}/artifacts \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "artifacts": [
      {
        "key": "data/login-test-chromium/video.webm",
        "url": "https://prod-empirical-test-reports-ap-south-1.s3.ap-south-1.amazonaws.com/my-app/456/data/login-test-chromium/video.webm",
        "size": 749023,
        "last_modified": "2024-01-15T10:32:00.000Z"
      }
    ]
  }
}

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 URLs to artifacts stored for a test run. You can filter by exact key, prefix, suffix, or retrieve all artifacts. 
{
  "data": {
    "artifacts": [
      {
        "key": "data/login-test-chromium/video.webm",
        "url": "https://prod-empirical-test-reports-ap-south-1.s3.ap-south-1.amazonaws.com/my-app/456/data/login-test-chromium/video.webm",
        "size": 749023,
        "last_modified": "2024-01-15T10:32:00.000Z"
      }
    ]
  }
}

​
Get a specific artifact

Fetch a single artifact by exact key. This is the most efficient query — it makes a single S3 lookup. 
curl -X GET \
  "https://dash.empirical.run/api/test-runs/456/artifacts?key=summary.json" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY"

​
List all video recordings

curl -X GET \
  "https://dash.empirical.run/api/test-runs/456/artifacts?suffix=.webm" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY"

​
List all artifacts in a directory

curl -X GET \
  "https://dash.empirical.run/api/test-runs/456/artifacts?prefix=data/login-test-chromium/" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY"

​
List all artifacts

Omit all query parameters to list every artifact in the test run. 
curl -X GET \
  "https://dash.empirical.run/api/test-runs/456/artifacts" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY"

Authorizations

​
Authorization
string
header
required

Project API key from the Empirical dashboard.

Path Parameters

​
id
integer
required

Test run ID.

Required range: -9007199254740991 <= x <= 9007199254740991

Query Parameters

​
key
string

Exact artifact path relative to the test run.

​
prefix
string

Filter artifacts by path prefix.

​
suffix
string

Filter artifacts by file extension or suffix.

Response

List of artifacts.

​
data
object
required