Get All Test Executions by Plan

9 min

The endpoint allows users to retrieve all test executions for a specific test plan. The results are returned as a paginated list, starting from the first page.

Endpoint Information

URL: <custom-env-url>/Testinium.RestApi/api/plans/{id}/testExecutions?companyId={companyId}

Method: GET

Authentication: Bearer Token is required

Path Variables

Parameter	Type	Required	Description
id	Long	Yes	The unique identifier of the test plan.

Request Parameters

Parameter	Type	Required	Description
companyId	Long	Yes	The unique identifier of the company.

Response Body

Upon a successful request, the API returns a paginated list of test executions in the form of a PaginatedTestExecutionList object.

{
    "pagination": {
        "current_page": 1,
        "total_count": 5,
        "page_limit": 50
    },
    "execution_list": [
        {
            "id": 4400,
            "plan": {
                "id": 261
            },
            "start_date": 1735547202000,
            "end_date": 1735547205000,
            "test_results": [],
            "result_summary": {
                "ERROR": 1
            },
            "test_result_status_counts": "[ERROR, 1]"
        },
        {
            "id": 4399,
            "plan": {
                "id": 261
            },
            "start_date": 1735547163000,
            "end_date": 1735547165000,
            "test_results": [],
            "result_summary": {
                "ERROR": 1
            },
            "test_result_status_counts": "[ERROR, 1]"
        },
        {
            "id": 4398,
            "plan": {
                "id": 261
            },
            "start_date": 1735547152000,
            "end_date": 1735547155000,
            "test_results": [],
            "result_summary": {
                "ERROR": 1
            },
            "test_result_status_counts": "[ERROR, 1]"
        },
        {
            "id": 4296,
            "plan": {
                "id": 261
            },
            "start_date": 1734944129000,
            "end_date": 1734944130000,
            "test_results": [],
            "result_summary": {
                "ERROR": 1
            },
            "test_result_status_counts": "[ERROR, 1]"
        },
        {
            "id": 4295,
            "plan": {
                "id": 261
            },
            "start_date": 1734944103000,
            "end_date": 1734944103000,
            "test_results": [],
            "result_summary": {
                "ERROR": 1
            },
            "test_result_status_counts": "[ERROR, 1]"
        }
    ]
}

Field	Type	Description
pagination	Object	Contains pagination details.
current_page	int	The current page number.
total_count	int	The total number of test executions.
page_limit	int	The maximum number of results per page.
execution_list	Array	A list of test execution details (empty in this case).

Error Codes

HTTP Code	Error Message	Description
404	Plan not found	The specified test plan was not found.
500	Internal Server Error	An unexpected error occurred on the server side.

Example Request

curl --location '<custom-env-url>/Testinium.RestApi/api/plans/{id}/testExecutions?companyId={companyId}' \
--header 'Authorization: Bearer <your_access_token>'