Data Hub
Runs

List a run's report items

Requires scope `files:read`. Returns `{id, filename}` for the run's renderable images, PDFs, or spectra, ordered by filename. Paged with `offset`/`limit` so viewers can seek by item index.

GET
/instruments/{instrumentId}/runs/{runId}/report-items

Requires scope files:read. Returns {id, filename} for the run's renderable images, PDFs, or spectra, ordered by filename. Paged with offset/limit so viewers can seek by item index.

Authorization

bearerAuth
AuthorizationBearer <token>

Personal access tokens begin with dhub_… and are restricted by their assigned scopes.

In: header

Path Parameters

instrumentId*string
runId*string

Query Parameters

kind*string

Which renderable artifacts to list.

Value in

  • "image"
  • "pdf"
  • "spectrum"
search?string

Case-insensitive filename substring filter.

offset?|
Range0 <= value
limit?integer
Range1 <= value <= 200
anchor?integer

File id to centre the window on. Overrides offset and returns the item's position as anchor_index.

Range0 < value

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/instruments/plate-reader/runs/run-2026-001/report-items?kind=image"
{  "data": [    {      "id": 0,      "filename": "string"    }  ],  "pagination": {    "offset": 0,    "limit": 0,    "total": 0,    "anchor_index": 0  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}
{  "error": {    "code": "string",    "message": "string",    "details": {      "property1": null,      "property2": null    }  }}