> For the complete documentation index, see [llms.txt](https://testinium.gitbook.io/enterprise-test-automation-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://testinium.gitbook.io/enterprise-test-automation-docs/apis/enterprise-2.0/reports/find-test-result-by-session-id.md).

# Find Test Result by Session ID

The endpoint retrieves a test result based on the provided session ID and the user's associated company.

***

### Endpoint Information

* **URL**: `<custom-env-url>/Testinium.RestApi/api/testResults/session/{sessionId}`
* **Method**: `GET`
* **Authentication**: `Bearer Token` is required

***

### Path Parameter

| Parameter   | Type     | Required | Description                              |
| ----------- | -------- | -------- | ---------------------------------------- |
| `sessionId` | `String` | Yes      | The unique session ID of the test result |

***

### Response Body

The response will contain a `TestResultDTO` object if a test result is found for the specified session ID and company associated with the authenticated user.

```json
{
  "id": 102,
  "sessionId": "unique-session-id",
  "user": {
    "id": 34,
    "username": "testUser"
  },
  "company": {
    "id": 56,
    "name": "TestCompany"
  },
  "nodeLogPath": "/logs/testResult.log",
  "videoPath": "/videos/testResult.mp4",
  "status": "SUCCESS",
  "runtime": 78000,
  "start_date": 1450890157000,
  "end_date": 1450890235000
}

```

| Field         | Type     | Description                                                     |
| ------------- | -------- | --------------------------------------------------------------- |
| `id`          | `Long`   | The unique ID of the test result.                               |
| `sessionId`   | `String` | The session identifier of the test result.                      |
| `user`        | `Object` | Information about the user who created the test result.         |
| `company`     | `Object` | Information about the company associated with this test result. |
| `nodeLogPath` | `String` | Path to the log file.                                           |
| `videoPath`   | `String` | Path to the video file.                                         |
| `status`      | `String` | The status of the test result (e.g., `SUCCESS`).                |
| `runtime`     | `Long`   | Execution time of the test in milliseconds.                     |
| `start_date`  | `Long`   | Start timestamp of the test execution.                          |
| `end_date`    | `Long`   | End timestamp of the test execution.                            |

***

### Error Codes

| HTTP Code | Error Message           | Description                                        |
| --------- | ----------------------- | -------------------------------------------------- |
| `400`     | `Invalid Request`       | The request was malformed or contained errors.     |
| `401`     | `Unauthorized`          | User authentication failed.                        |
| `403`     | `Access denied`         | User does not have access to this test result.     |
| `404`     | `Test Result Not Found` | No test result was found for the given session ID. |
| `500`     | `Internal Server Error` | An unexpected error occurred on the server side.   |

***

### Example Request

```bash
curl -X GET "<custom-env-url>/Testinium.RestApi/api/testResults/session/unique-session-id' \
--header 'Authorization: Bearer <your_access_token>'
```