Skip to main content

​
Test Results

Fetch execution status, results, and history using the executions endpoint with various filters.

​
Fetch Execution Status/Results

Use the GET /executions endpoint with filters to search for executions, or GET /executions/:id to fetch a specific execution.

​
Request by ID

EXECUTION_ID="YOUR_EXECUTION_ID"

curl -sS --location "$API_URL/executions/$EXECUTION_ID" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

​
Request by Batch (applicationExecutionId)

APPLICATION_EXECUTION_ID="YOUR_APPLICATION_EXECUTION_ID"

curl -sS --location "$API_URL/executions?applicationExecutionId=$APPLICATION_EXECUTION_ID" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

​
Possible Statuses

StatusDescriptionTerminal?
QUEUEDWaiting to start❌
PREFLIGHT_RUNNINGPreflight checks in progress❌
PREFLIGHT_COMPLETEDPreflight checks completed successfully❌
PREFLIGHT_FAILEDPreflight checks failed✅
RUNNINGExecution in progress❌
GENERATING_REPORTExecution finished, generating report❌
FINISHEDCompleted successfully✅
FAILEDFailed✅
CANCELEDCanceled by user✅
TIMED_OUTExecution timeout✅
Note: Statuses marked as “Terminal” indicate the execution has reached a final state and will not change.

​
Fetch Execution History

Use the applicationId to fetch all executions for an application.

​
Request

APPLICATION_ID="YOUR_APPLICATION_ID"

curl -sS --location "$API_URL/executions?applicationId=$APPLICATION_ID" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

​
Optional Query Parameters

ParameterTypeDescription
applicationIdstringFilter by application
applicationExecutionIdstringFilter by batch/trigger
planIdstringFilter by test plan
statusstringFilter by status
environmentstringFilter by environment
providerstringFilter by provider (e.g., PLAYWRIGHT)
testCaseSlugstringFilter by test case slug
dateFromstringFilter executions from date (ISO 8601 format)
dateTostringFilter executions to date (ISO 8601 format)
triggeredBystringFilter by user who triggered (use __system__ for automated)
searchstringSearch by execution code (case-insensitive partial match)
sortBystringSort field (default: createdAt)
sortDirstringSort direction: asc or desc (default: desc)
pagenumberPage number (default: 1)
limitnumberItems per page (default: 20, max: 100)

​
Response

{
  "data": [
    {
      "_id": "698249a1844033a881c78196",
      "code": "EX-0042",
      "status": "FINISHED",
      "stats": { "total": 10, "passed": 9, "failed": 1, "skipped": 0 },
      "createdAt": "2026-02-03T12:00:00.000Z"
    },
    {
      "_id": "698249a1844033a881c78195",
      "code": "EX-0041",
      "status": "FINISHED",
      "stats": { "total": 10, "passed": 10, "failed": 0, "skipped": 0 },
      "createdAt": "2026-02-02T12:00:00.000Z"
    }
  ],
  "total": 42,
  "page": 1,
  "limit": 20,
  "pages": 3
}
For real-time notifications without polling, use webhooks to receive results automatically when executions complete.

​
Next Steps