---
title: "Get test by ID"
method: GET
path: "/tests/{testId}"
tags: ["Tests"]
---

# Get test by ID

`GET /tests/{testId}`

Gets a test by ID. Test IDs can be found in Vanta in URL bar after /tests/.

## Path parameters

- `testId` string, required

## Response `200`

Ok

- Test
  - `id` string, required — The test's unique ID.
  - `name` string, required — The test's name.
  - `lastTestRunDate` string, date-time, required — The timestamp of the last test run.
  - `latestFlipDate` string, date-time, nullable, required — The most recent date when the test flipped.
  - `description` string, required — The test's description.
  - `failureDescription` string, required — The test's failure description.
  - `remediationDescription` string, required — The test's remediation description.
  - `version` object, required — The test's version.
    - `minor` number, double, required — The minor version number.
    - `major` number, double, required — The major version number.
  - `category` 'Accounts access' | 'Account security' | 'Account setup' | 'Computers' | 'Custom' | 'Data storage' | 'Employees' | 'Infrastructure' | 'IT' | 'Logging' | 'Monitoring alerts' | 'People' | 'Policies' | 'Risk analysis' | 'Software development' | 'CSPM alert management' | 'Vendors' | 'Vulnerability management', required
  - `integrations` string[], required — This test's third-party integration dependencies.
  - `status` 'OK' | 'DEACTIVATED' | 'NEEDS_ATTENTION' | 'IN_PROGRESS' | 'INVALID' | 'NOT_APPLICABLE', required
  - `deactivatedStatusInfo` DeactivatedStatusInfo, required
    - `isDeactivated` boolean, required — The deactivated status of the test.
    - `deactivatedReason` string, nullable, required — The reason for deactivation.
    - `lastUpdatedDate` string, date-time, nullable, required — The date of the last update to the deactivated status.
  - `remediationStatusInfo` RemediationStatusInfo, required
    - `status` 'DISABLED' | 'DUE_SOON' | 'INVALID' | 'IN_PROGRESS' | 'NA' | 'NEEDS_WORK' | 'OVERDUE' | 'PASS', required — Enum for the possible test remediation statuses
    - `soonestRemediateByDate` string, date-time, nullable, required — The soonest date by which the remediation should be completed.
    - `itemCount` number, double, required — The number of items that need remediation.
  - `owner` Owner, required
    - `id` string, required — Unique identifier for the person.
    - `displayName` string, required — Name of the person that is shown in product.
    - `emailAddress` string, required — Email address of the person.

---

[API](https://skmtc.net/vanta/apis/build-integrations.md) · [All operations](https://skmtc.net/vanta/apis/build-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vanta/build-integrations/revisions/6c1f7590538b/schema)