> ## Documentation Index > Fetch the complete documentation index at: https://developer.vanta.com/llms.txt > Use this file to discover all available pages before exploring further. # Get test by ID > Gets a test by ID. Test IDs can be found in Vanta in URL bar after /tests/. ## OpenAPI ````yaml /reference/manage-vanta.json get /tests/{testId} openapi: 3.0.0 info: title: Manage Vanta version: 1.0.0 description: >- The REST API lets customers query and mutate Vanta's data. Use this API to automate bulk actions, query data for custom workflows and dashboards, and bolster your security operations **Note for Vanta Gov (FedRAMP) customers:** Select `Vanta Gov (FedRAMP)` from the server dropdown to issue requests against `https://api.vanta-gov.com`. The OAuth token URL shown below defaults to the commercial host — replace it with `https://api.vanta-gov.com/oauth/token`. termsOfService: https://www.vanta.com/terms license: name: UNLICENSED contact: name: API Support url: https://help.vanta.com/ email: support@vanta.com servers: - url: https://api.vanta.com/v1 description: Vanta (Commercial) - url: https://api.vanta-gov.com/v1 description: Vanta Gov (FedRAMP) security: [] paths: /tests/{testId}: get: tags: - Tests summary: Get test by ID description: >- Gets a test by ID. Test IDs can be found in Vanta in URL bar after /tests/. operationId: GetTest parameters: - in: path name: testId required: true schema: type: string example: aws-account-access-removed-on-termination responses: '200': description: Ok content: application/json: schema: $ref: '#/components/schemas/Test' examples: Example 1: value: id: aws-account-access-removed-on-termination name: AWS accounts deprovisioned when personnel leave lastTestRunDate: '2024-06-18T20:17:38.463Z' latestFlipDate: null description: > Verifies that AWS accounts linked to removed users are removed. failureDescription: >- Some AWS accounts associated with terminated personnel have not been deactivated. remediationDescription: | Remove all accounts listed from AWS. version: major: 0 minor: 0 category: Account security integrations: - aws status: OK deactivatedStatusInfo: isDeactivated: false deactivatedReason: null lastUpdatedDate: null remediationStatusInfo: status: PASS soonestRemediateByDate: null itemCount: 0 owner: null security: - bearerAuth: [] components: schemas: Test: properties: id: type: string description: The test's unique ID. name: type: string description: The test's name. lastTestRunDate: type: string format: date-time description: The timestamp of the last test run. latestFlipDate: type: string format: date-time nullable: true description: The most recent date when the test flipped. description: type: string description: The test's description. failureDescription: type: string description: The test's failure description. remediationDescription: type: string description: The test's remediation description. version: properties: minor: type: number format: double description: The minor version number. major: type: number format: double description: The major version number. required: - minor - major type: object description: The test's version. category: $ref: '#/components/schemas/DocumentAndTestCategory' description: The test's category. integrations: items: type: string type: array description: This test's third-party integration dependencies. status: $ref: '#/components/schemas/TestStatus' description: This test run's status. deactivatedStatusInfo: $ref: '#/components/schemas/DeactivatedStatusInfo' description: The test's deactivation status. remediationStatusInfo: $ref: '#/components/schemas/RemediationStatusInfo' description: The test's remediation status. owner: allOf: - $ref: '#/components/schemas/Owner' nullable: true description: The test's owner. required: - id - name - lastTestRunDate - latestFlipDate - description - failureDescription - remediationDescription - version - category - integrations - status - deactivatedStatusInfo - remediationStatusInfo - owner type: object additionalProperties: false DocumentAndTestCategory: type: string enum: - 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 TestStatus: enum: - OK - DEACTIVATED - NEEDS_ATTENTION - IN_PROGRESS - INVALID - NOT_APPLICABLE type: string DeactivatedStatusInfo: properties: isDeactivated: type: boolean description: The deactivated status of the test. deactivatedReason: type: string nullable: true description: The reason for deactivation. lastUpdatedDate: type: string format: date-time nullable: true description: The date of the last update to the deactivated status. required: - isDeactivated - deactivatedReason - lastUpdatedDate type: object additionalProperties: false RemediationStatusInfo: properties: status: $ref: '#/components/schemas/TestRemediationStatus' description: The status of the remediation. soonestRemediateByDate: type: string format: date-time nullable: true description: The soonest date by which the remediation should be completed. itemCount: type: number format: double description: The number of items that need remediation. required: - status - soonestRemediateByDate - itemCount type: object additionalProperties: false Owner: properties: id: type: string description: Unique identifier for the person. displayName: type: string description: Name of the person that is shown in product. emailAddress: type: string description: Email address of the person. required: - id - displayName - emailAddress type: object additionalProperties: false TestRemediationStatus: description: Enum for the possible test remediation statuses enum: - DISABLED - DUE_SOON - INVALID - IN_PROGRESS - NA - NEEDS_WORK - OVERDUE - PASS type: string securitySchemes: bearerAuth: type: http scheme: bearer ````