Get Results

To view a test job result, you can either view a short summary report or download a detailed test job result.

View a summary report

You can click a finished test job to view the summary report. It shows what test suites and test cases were run, what environment was used, and the status of the assertions:

TestEngine Web Reports

Get test job results

To download detailed results of a test job run, you can either use the web interface of TestEngine or send a request to the TestEngine API using curl, ReadyAPI, or any other similar tool.

Using API

Get an overview of test jobs in TestEngine

Use the following operation:

GET  http://<testengine-host>:8080/api/v1/testjobs

Authentication

The request must be authenticated by a TestEngine user.

Note

If you authenticate as a non-admin user, you will be able to view only those reports on test jobs that you have started. If you authenticate as an administrator, you will be able to view all the test jobs in TestEngine.

go.gifSee details on SwaggerHub in the ReadyAPI TestEngine API – Get Test Jobs section.

Example
curl

Use the following command line:

curl -u "user:password" -X GET "http://localhost:8080/api/v1/testjobs"

In this example:

-u user:password

Authenticates the request with the user’s credentials.

-X GET

Specifies the GET method.

"http://localhost:8080/api/v1/testjobs"

The endpoint of the request.

ReadyAPI

  1. Create a project by using the TestEngine API definition. See Creating Project From OpenAPI/Swagger Definition to learn how to do it.

    Tip

    You can also create the needed request from scratch.

  2. Select the GET request to the /testjobs resource:

    Authenticate by using an access token: An access token

  3. Open the Auth panel.

  4. Select the Basic (Built-in) authorization type.

    Tip

    If you use the same credentials in several requests, use authorization profiles.

  5. Specify user credentials and select the Authenticate pre-emptively option:

    Get peak TestEngine usage statistics: Add authorization

  6. Send the request:

    Get test job overview in ReadyAPI: Send the request

  7. The response will list all the test jobs the user is authorized to view.

    Get test job overview in ReadyAPI: View the response

Get a full report on a test job

Use the following operation:

GET  http://<testengine-host>:8080/api/v1/testjobs/{testjobId}/report

Authentication

The request must be authenticated by a TestEngine user.

Note

Results that you see depend on the authentication. If you authenticate as a user, you will see only the test jobs started by that user; if you authenticate as an administrator, you will see all the test jobs in TestEngine.

Headers

Header

Description

Accept

Specifies the format of the report. Possible values:

  • application/json (for a JSON report)

  • application/junit+xml (for a report of the JUnit XML format)

  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (for an Excel report)

  • application/pdf (for a PDF report)

If the header is not set explicitly, a JSON report will be returned.

go.gifSee details on SwaggerHub.

Example
curl

Use the following command line:

curl -u "user:password" -H "Accept:application/junit+xml" -X GET "http://localhost:8080/api/v1/testjobs/{testjobId}/report"

In this example:

-u user:password

Authenticates the request with the user’s credentials.

-H "Accept:application/junit+xml"

Specifies the report format. In this example, TestEngine will send a report of the JUnit XML format.

-X GET

Specifies the GET method.

"http://localhost:8080/api/v1/testjobs/{testjobId}/report"

The endpoint of the request.

The response will contain a report on the test job run in the form of a file of the JUnit XML format.

ReadyAPI

  1. Create a project by using the TestEngine API definition. See Creating Project From OpenAPI/Swagger Definition to learn how to do it.

    Tip

    You can also create the needed request from scratch.

  2. Select the GET request to the /api/v1/testjobs/{testjobId}/report resource:

    Check the status of a certain test job: Select a request

  3. Enter the test job's id in the Value field of the testjobId parameter:

    Check the status of a certain test job: Enter a test job id

  4. Add a new parameter:

    • Name: Accept

    • Value: The type of the report you want to get. For example, application/junit+xml (see above).

    • Type: HEADER

    Get a report on a test job: Enter a test job id

  5. Open the Auth panel.

  6. Select the Basic (Built-in) authorization type.

    Tip

    If you use the same credentials in several requests, use authorization profiles.

  7. Specify user credentials and select the Authenticate pre-emptively option:

    Get peak TestEngine usage statistics: Add authorization

  8. Send the request:

    Check the status of a certain test job: Send the request

  9. The response will contain a report on the test job run in the form of a file of the JUnit XML format:

    Get a report on a test job: View the report

Using Web UI

To see test job results, go to the Run History page of TestEngine:

http://<testengine-host>:<port>/run-history

For example, if TestEngine is installed on your local machine and you run it on the default port, use the following link:

http://localhost:8080/run-history

The Run History page of the TestEngine web interface contains a list of existing test jobs:

webui-run-history-page.png

Tip

You can filter test jobs by a name, status, used tags, and the user who has sent the job. Besides that, you can search for a specific test job by a string included in its project, author, status, type, or tag.

The table contains brief information on test jobs:

Column

Description

Project

The name of the project to run.

Status

Current state of a test job.

Possible statuses: Canceled, Failed, Finished.

Tip

Test jobs with the Running and In Queue statuses are listed on the Overview page.

Success Ratio

Shows the number of tests that have passed/failed for the given execution.

Author

The name of the user, who sent the test job to TestEngine.

Administrators can examine test jobs created by other users.

Test Type

Shows whether the test job is a functional test or security test.

Important

Currently, TestEngine does not support load tests.

Tags

Shows which tags were used to run the test job.

Start Time

A timestamp when the test job was sent to TestEngine.

Queue Time

How much time the test was in the queue.

Run Time

The time of the test run.

Total Time

The total time of the test run, including the time in the queue.

Test job ID

Get the test job ID.

Download job report

Download the test job report in the JSON, JUnit XML, Excel or PDF format.

Remove the test job

Remove the test job from the test history.

Get transaction report

A transaction report is a JSON file that contains full information on HTTP transactions that took place during a test job run. Transactions are logged only for request test steps, such as SOAP Request, REST Request, and so on.

Get a report on all the transactions within a test job

Use the following operation:

GET  http://<testengine-host>:8080/api/v1/testjobs/{testjobId}/transactions

Authentication

The request must be authenticated by a TestEngine user.

Note

Results that you see depend on the authentication. A user can see only the transactions of test jobs that they have started; an administrator can see transactions of all the jobs in TestEngine.

go.gifSee details on SwaggerHub in the ReadyAPI TestEngine API – Get Transactions section.

Example
curl

Use the following command line:

curl -u "user:password" -X GET "http://localhost:8080/api/v1/testjobs/{testjobId}/transactions/{transactionId}"

In this example:

-u user:password

Authenticates the request with the user’s credentials.

-X GET

Specifies the GET method.

"http://localhost:8080/api/v1/testjobs/{testjobId}/transactions/{transactionId}"

The endpoint of the request.

The response will contain a report on the transaction in the form of a JSON file.

ReadyAPI

  1. Create a project by using the TestEngine API definition. See Creating Project From OpenAPI/Swagger Definition to learn how to do it.

    Tip

    You can also create the needed request from scratch.

  2. Select the GET request to the /api/v1/testjobs/{testjobId}/transactions resource:

    Get a full transaction report: Select a request

  3. Enter the test job id as the value of the testjobId parameter:

    Get a full transaction report: Enter test job id

  4. Open the Auth panel.

  5. Select the Basic (Built-in) authorization type.

    Tip

    If you use the same credentials in several requests, use authorization profiles.

  6. Specify the user credentials and select the Authenticate pre-emptively option:

    Get peak TestEngine usage statistics: Add authorization

  7. Send the request:

    Get a full transaction report: Send the request

  8. The response will contain a report on the transactions in the form of a JSON file:

    Get a full transaction report: View the transaction report

Get a transaction report for a particular transaction

Use the following operation:

GET  http://<testengine-host>:8080/api/v1/testjobs/{testjobId}/transactions/{transactionId}

Authentication

The request must be authenticated by a TestEngine user.

Note

Results that you see depend on the authentication. A user can see only the transactions of test jobs that they have started; an administrator can see transactions of all the jobs in TestEngine.

go.gifSee details on SwaggerHub in the ReadyAPI TestEngine API – Get Transaction section.

Example
curl

Use the following command line:

curl -u "user:password" -X GET "http://localhost:8080/api/v1/testjobs/{testjobId}/transactions/{transactionId}"

In this example:

-u user:password

Authenticates the request with the user’s credentials.

-X GET

Specifies the GET method.

"http://localhost:8080/api/v1/testjobs/{testjobId}/transactions/{transactionId}"

The endpoint of the request.

The response will contain a report on the transaction in the form of a JSON file.

ReadyAPI

  1. Create a project by using the TestEngine API definition. See Creating Project From OpenAPI/Swagger Definition to learn how to do it.

    Tip

    You can also create the needed request from scratch.

  2. Select the GET request to the /api/v1/testjobs/{testjobId}/transactions/{transactionId} resource:

    Get a transaction report: Select a request

  3. Enter the test job id and transaction id in the respective fields:

    Get a transaction report: Enter test job id and transaction id

  4. Open the Auth panel.

  5. Select the Basic (Built-in) authorization type.

    Tip

    If you use the same credentials in several requests, use authorization profiles.

  6. Specify user credentials and select the Authenticate pre-emptively option:

    Get peak TestEngine usage statistics: Add authorization

  7. Send the request:

    Get a transaction report: Send the request

  8. The response will contain a report on the transaction in the form of a JSON file:

    Get a transaction report: View the transaction report

See Also

In this section:
© 2025
Publication date: