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

# Get test entities by test ID

`GET /tests/{testId}/entities`

Gets a list of tested items (entities) for a test by test ID. An entity is a tested item that can have its own outcome.
For example, for a test that makes sure that all S3 buckets are versioned, an individual S3 bucket would be an entity.

## Path parameters

- `testId` string, required

## Query parameters

- `entityStatus` 'FAILING' | 'DEACTIVATED'
- `pageSize` integer — Controls the maximum number of items returned in one response from the API.
- `pageCursor` string — A marker or pointer, telling the API where to start fetching items for the subsequent page in a paginated dataset. Note that the requested page will not include the item that corresponds to this cursor but will start from the one immediately after this cursor.

## Response `200`

Ok

- PaginatedResponseTestResourceEntity
  - `results` object, required
    - `data` TestResourceEntity[], required
      - `id` string, required — The identifier for the entity.
      - `entityStatus` 'FAILING' | 'DEACTIVATED', required
      - `displayName` string, required — The display name of the entity.
      - `responseType` string, required — The response type of the entity.
      - `deactivatedReason` string, nullable, required — The reason for deactivation.
      - `lastUpdatedDate` string, date-time, required — The date of the last update to the test entity. Falls back to the test run date if there is no remediation timeline.
      - `createdDate` string, date-time, required — The date where the test entity was first detected. Falls back to the test run date if there is no remediation timeline.
    - `pageInfo` PageInfo, required — Provides information about the pagination of a dataset.
      - `endCursor` string, nullable, required — The cursor that points to the end of the current page, or null if there is no such cursor.
      - `hasNextPage` boolean, required — Indicates if there is another page after the current page.
      - `hasPreviousPage` boolean, required — Indicates if there is a page before the current page.
      - `startCursor` string, nullable, required — The cursor that points to the start of the current page, or null if there is no such cursor.

---

[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)