Skip to main content
GET
/
api
/
test-runs
/
{id}
/
artifacts
List Artifacts
curl --request GET \
  --url https://api.example.com/api/test-runs/{id}/artifacts \
  --header 'Authorization: <authorization>'
{
  "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"
      }
    ]
  }
}
Returns URLs to artifacts stored for a test run. You can filter by exact key, prefix, suffix, or retrieve all artifacts.

​
Examples

​
Request

​
Authorization
string
required
Bearer token for authentication. Format: Bearer <your-api-key>
​
id
number
required
The unique identifier of the test run.
​
key
string
Exact artifact path relative to the test run. Uses a single lookup — most efficient for fetching a known file.
​
prefix
string
Filter artifacts by path prefix. Useful for listing files in a specific directory.
​
suffix
string
Filter artifacts by file extension or suffix. Can be combined with prefix.

​
Response

​
data.artifacts
array
List of matching 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"