Results

The results namespace provides API methods to retrieve test results for a run. This page covers the following API methods:

• GET /runs/{run_id}/results

GET /runs/{run_id}/results

Returns all test results for a run.

This method uses pagination so you might need to request additional pages to retrieve all results.

run_id id required ID of the run.

Request

Parameters

page integer Number of page to return (default: first page)
per_page integer Maximum number of results to return (supported: 15, 25, 50, 100; default: 100)
sort string Sort field for the list of results (supported: run_results:created_at; default: run_results:created_at)
order string Sort order (ascending or descending) (supported: asc, desc; default: desc)
created_after string Limit result set to results created after (in ISO8601 format and UTC time zone).
created_before string Limit result set to results created before (in ISO8601 format and UTC time zone).
created_by integer Comma-separated list of users to filter by.
assignee_id integer Comma-separated list of assignees to filter by. Use assignee_id=0 for unassigned test case results.
status_id integer Comma-separated list of statuses to filter by. The system supports up to 25 total statuses. Use the ID keys & name values as defined in your instance, typically: 1 for Untested, 2 for Passed, 3 for Failed, 4 for Retest, 5 for Blocked, 6 for Skipped. Unless modified by your administrator, custom statuses will have IDs 7-25.
get_latest_result boolean Indicates whether to fetch only the latest result (true, 1) or all results (false, 0).
expands string Comma-separated list of expands to filter by.

Schema

"page": {
        "type": "integer",
        "format": "int64",
        "description": "Number of pages to return (default: first page)."
},
"per_page": {
    "type": "integer",
    "format": "int64",
    "enum": [
        15,
        25,
        50,
        100
    ],
    "description": "Maximum number of results to return (default: 100)."
},
"sort": {
    "type": "string",
    "enum": [
        "run_results:created_at"
    ],
    "description": "Sort field for the list of results."
},
"order": {
    "type": "string",
    "enum": [
        "asc",
        "desc"
    ],
    "default": "desc",
    "description": "Sort order (ascending or descending)."
},
"created_after": {
    "type": "string",
    "format": "date-time",
    "description": "Limit result to results created after (in ISO8601 format and UTC time zone)."
},
"created_before": {
    "type": "string",
    "format": "date-time",
    "description": "Limit result to results created before (in ISO8601 format and UTC time zone)."
},
"created_by": {
    "type": "integer",
    "description": "Comma-separated list of users to filter by."
},
"assigned_id": {
    "type": "string",
    "description": "Comma-separated list of assignees to filter by."
},
"get_latest_result": {
    "type":  "boolean",
    "description": "Indicates whether to fetch only the latest result (true) or all results (false)."
},
"status": {
    "type": "string",
    "description": "Comma-separated list of statuses to filter by. The system supports up to 25 total statuses. Use the ID keys & name values as defined in your instance, typically: 1 for Untested, 2 for Passed, 3 for Failed, 4 for Retest, 5 for Blocked, 6 for Skipped. Unless modified by your administrator, custom statuses will have IDs 7-25. "
},
"expands": {
    "type": "string",
    "description": "Comma-separated list of expands to return."
}

Response

{
  "page": 1,
  "prev_page": null,
  "next_page": 2,
  "last_page": 16,
  "per_page": 25,
  "total": 392,
  "result": [
    {
      "id": 538,
      "project_id": 1,
      "run_id": 1,
      "test_id": 64,
      "case_id": 1078,
      "status_id": 6,
      "note": "<p>Skipped due to prerequisite conditions not met in the current system configuration. Retesting in next sprint.<\/p>",
      "elapsed": 240000000,
      "assignee_id": null,
      "is_latest": true,
      "issues": [],
      "created_at": "2025-02-07T09:39:21.211Z",
      "created_by": 1,
      "updated_at": null,
      "updated_by": null,
      "deleted_at": null,
      "deleted_by": null
    },
    {
      "id": 539,
      "project_id": 1,
      "run_id": 1,
      "test_id": 166,
      "case_id": 1080,
      "status_id": 6,
      "note": "<p>Skipped due to prerequisite conditions not met in the current system configuration. Retesting in next sprint.<\/p>",
      "elapsed": 240000000,
      "assignee_id": null,
      "is_latest": true,
      "issues": [],
      "created_at": "2025-02-07T09:39:21.211Z",
      "created_by": 1,
      "updated_at": null,
      "updated_by": null,
      "deleted_at": null,
      "deleted_by": null
    },
    ..
  ],
  "expands": {
   ..
  }
}

Examples

// Get results for run with ID 1
/api/v1/runs/1/results

// Get results and limit to 1 page with 25 results including expands
/api/v1/runs/1/results?page=1&per_page=25&expands=issues,users

Status codes

200 400 401 403 422 (details)