> For the complete documentation index, see [llms.txt](https://docs.suggestic.com/graphql/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suggestic.com/graphql/query/queries/lab-tests/lab-test-reports.md).

# Lab Test Reports

Use the `labTestReports` query to get the list of all lab test reports created for the user. 

### Available Arguments

| Argument        | Type    | Description                                                                                            |
| --------------- | ------- | ------------------------------------------------------------------------------------------------------ |
| `first`         | Int     | Retrieves the first results from the list.                                                             |
| `after`         | String  | See [pagination](https://docs.suggestic.com/graphql/start-here/tutorials-and-walkthroughs/pagination). |
| `before`        | String  | See [pagination](https://docs.suggestic.com/graphql/start-here/tutorials-and-walkthroughs/pagination). |
| `id`            | ID      | Id of the Lab Test Report.                                                                             |
| `last`          | Int     | See [pagination](https://docs.suggestic.com/graphql/start-here/tutorials-and-walkthroughs/pagination). |
| `isVisible`     | Boolean | True if the report is visible. Otherwise, it displays false                                            |
| `externalId`    | String  | Filter by externalId                                                                                   |
| `orderId`       | String  | Filter by orderId                                                                                      |
| `requisitionId` | String  | Filter by requisitionId                                                                                |

### Available Fields

| Field Name    | Type        | Description                                                                                                                                                                                                                                                                                  |
| ------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`          | ID          | Lab test report ID.                                                                                                                                                                                                                                                                          |
| `testName`    | String      | Lab test report name.                                                                                                                                                                                                                                                                        |
| `isVisible`   | Boolean     | True if the report is visible. Otherwise, it displays false.                                                                                                                                                                                                                                 |
| `reportPdf`   | URL         | Lab test report url.                                                                                                                                                                                                                                                                         |
| `status`      | String      | Lab test report status. Possible values: `created`, `ordered`, `fulfilled, error`, `returned_to_lab`, or `results_ready.`                                                                                                                                                                    |
| `testDate`    | datetime    | Use the format: `YYYY-MM-DDT hh:mm:ssZ`                                                                                                                                                                                                                                                      |
| `alert`       | Boolean     | `True` if alert is active otherwise `False.`                                                                                                                                                                                                                                                 |
| `alertText`   | String      | Text shown in the alert.                                                                                                                                                                                                                                                                     |
| `alertAction` | AlertAction | <p></p><ul><li>ATTEMPTED\_FAILED: Unable to contact.</li><li>CONTACTED: Member Contacted and resolved.</li></ul>                                                                                                                                                                             |
| `alertStatus` | AlertStatus | <ul><li>IN\_REVIEW: In Review.</li><li>REVIEWED: Lab Reviewed - No Alerts.</li><li>OUT\_OF\_RANGE: Biomarker(s) Out of Range.</li><li>OTHER: Other.</li><li>FOLLOW\_UP: Follow-up Required.</li><li>NO\_FOLLOW\_UP: No Follow-up Required.</li><li>COMPLETED: Lab Alert Completed.</li></ul> |
| `videoUrl`    | String      | Video URL to show in the report.                                                                                                                                                                                                                                                             |

### Status Field description

| Status name        | Description                                     |
| ------------------ | ----------------------------------------------- |
| `created`          | Lab test report created.                        |
| `ordered`          | The order was placed with lab.                  |
| `fulfilled`        | The kit was shipped to the client.              |
| `error`            | There is a problem with the kit.                |
| `returned_to_lab`  | The results are returned to the lab.            |
| `results_ready`    | The lab test results are ready.                 |
| `Process complete` | There's processing after the results are ready. |

### Example

{% tabs %}
{% tab title="Request" %}

```graphql
query {
    labTestReports {
      edges {
        node {
          id
          testName
          reportPdf
          isVisible
          status
          alert
          alertAction
          alertStatus
          alertText
          videoUrl
        }
      }
    }
}
```

{% endtab %}

{% tab title="Response" %}

```graphql
{
  "data": {
      "labTestReports": {
        "edges": [
          {
            "node": {
              "id": "TGFiVGVzdFJlcG9ydDo3MA==",
              "testName": "Sugar test",
              "reportPdf": "https://storage.googleapis.com/sg-data/lab-test/5ed99232-ca13-4a65-92b2-fc098f829e04/biEd0KdheG7A.pdf?Expires=1643814637&GoogleAccessId=ibucket%40machine-learning-159617.iam.gserviceaccount.com&Signature=nKSJEp5fXSJ9RPhHKf5AK%2F5Nga9P%2FlZi3ZwTkSXesznGVrtfqQ%2BZcig0qswZsugOyyyMgJ6Eyfsb9zZj1R9UGO3bpgPezKXChKY3ygs3%2BbLSoZJyTD7SE8vSDn6uTdhNCrvd4tRojSxEoit%2Fitng%2Ba1V8Q0ErIwkySGIiRJfxKKd04k2doL4MhweU1tpM0xrUXxrW66EQDrmee4CSiF39pBLwrSp0YTgn%2FUj3jmqA88JIJ%2Fl5%2BInsLZ4O0742W00Ew6XQFBEPzLG1DLEYxKRv0DxIAPou7MI56nmSgZ9xdzuVgEsFKn3nNTufihobfqQPK6qs3Q8xZbFOZWdSUHkIQ%3D%3D",
              "isVisible": true,
              "status": "CREATED",
              "alert": true,
              "alertText":"Validation Error",
              "alertStatus":"REVIEWED",
              "alertAction":"CONTACTED",
              "videoUrl":"www.samplevideourl.com"
            }
          },
          {
            "node": {
              "id": "TGFiVGVzdFJlcG9ydDo2OA==",
              "testName": "Sugar test",
              "reportPdf": "https://storage.googleapis.com/sg-data/lab-test/5ed99232-ca13-4a65-92b2-fc098f829e04/JSB3xYKEVtbH.pdf?Expires=1643814637&GoogleAccessId=ibucket%40machine-learning-159617.iam.gserviceaccount.com&Signature=KHNSgTQaT%2Fs4%2BzyloAfiuL%2FQeYzXV%2BAxT03j%2FU0qm8LELUzesxF1ZN0zRJJmY6m4RpHZhkXKcSbLrhtTZ3HsENVYPfQxDJ4hApndlWuxTY32W5DyTcRJlJtfB3gu009AGZMAwVXEPA8afAhfq3lsWE0d26iO4u1LjO%2FEAZ%2FstsBAXKxYDHXLKnL8LIrC70dL1Ufw%2FLKU8ZXNxhDFqK6JRzvMLdMgpFrIJDi%2FNybI%2BRRk36w2xBn1ZIfbqk4EhNcwuaAGQVRzMOloG2s7K0HGVCus%2BBu6yphoDe78%2BV1h21TtOpxO4WALUhQgqShFXWJeKuJLnjywg%2BterXXeg%2F26yw%3D%3D",
              "isVisible": true,
              "status": "CREATED",
              "alert": true,
              "alertText":"Validation Error",
              "alertStatus":"REVIEWED",
              "alertAction":"CONTACTED",
              "videoUrl":"www.samplevideourl.com"
            }
          },
          {
            "node": {
              "id": "TGFiVGVzdFJlcG9ydDozOQ==",
              "testName": "Basic Metabolic Panel",
              "reportPdf": "https://storage.googleapis.com/sg-data/lab-test/5ed99232-ca13-4a65-92b2-fc098f829e04/qlH3adLcs0K2.pdf?Expires=1643814637&GoogleAccessId=ibucket%40machine-learning-159617.iam.gserviceaccount.com&Signature=igJT12FkKAIHPBhNqrn4dUIDbP9mpwxGkN3AszEvdK3s2JurFmZMo23Mr4ZNS%2BlIHUsZuhrBbUibTk5i3W96nD9uFrM6MWlQUVX%2FDf53vFdgJADf0ErxCtLQqf1unVXq5xDbOtOGSK7AU3rs0PgvOv1BYS1H75d%2B5X1tma4NCvvBkH2z04isL9ScA9HnJgcF21KHwGyRGiMU8r7aaV0HS6K6%2F7n259ME0zwqkC1qQwi6HpdcwN%2BQUdATqKSPNOLPafEQvkOqAJ%2B6nWqJE9D04XhPaNapUg1itSqIqr8eW1%2BA7NlNpKZTauxjYSCfk6MjAhdPAsE2ak%2BpX%2BG7yYHJ3Q%3D%3D",
              "isVisible": true,
              "status": "CREATED",
              "alert": true,
              "alertText":"Validation Error",
              "alertStatus":"REVIEWED",
              "alertAction":"CONTACTED",
              "videoUrl":"www.samplevideourl.com"
            }
          }
        ]
      }
  }
}
```

{% endtab %}
{% endtabs %}

### Example with Filter by orderId

{% tabs %}
{% tab title="Request" %}

```graphql
query {
    labTestReports (orderId:"418787") {
      edges {
        node {
          id
          testName
          externalId
          orderId
          requisitionId
        }
      }
    }
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "data": {
        "labTestReports": {
            "edges": [
                {
                    "node": {
                        "id": "TGFiVGVzdFJlcG5ydDo1ODc3MA==",
                        "testName": "Test Name",
                        "externalId": "56567558",
                        "orderId": "418787",
                        "requisitionId": "2221201683"
                    }
                }
            ]
        }
    }
}
```

{% endtab %}
{% endtabs %}