v1

latestOpenAPI 3.0.1Vanta Terms of Service2026-07-26327517821.8 KB
Tests

List tests

Lists all tests based on applied filters.

get/tests

Query parameters

pageSizeinteger

Controls the maximum number of items returned in one response from the API.

pageCursorstring

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.

statusFilter'OK' | 'DEACTIVATED' | 'NEEDS_ATTENTION' | 'IN_PROGRESS' | 'INVALID' | 'NOT_APPLICABLE'

Filter tests by test status. Possible values: OK (Test passed), DEACTIVATED (Test is deactivated), NEEDS_ATTENTION (Test failed), IN_PROGRESS (Test is in progress), INVALID (Test is invalid), NOT_APPLICABLE (Test is not applicable)

frameworkFilterstring

Filter tests by framework.

integrationFilterstring

Filter tests by integration.

controlFilterstring

Filter tests by control ID.

ownerFilterstring

Filter tests by owner ID.

categoryFilter'ACCOUNTS_ACCESS' | 'ACCOUNT_SECURITY' | 'ACCOUNT_SETUP' | 'COMPUTERS' | 'CUSTOM' | 'DATA_STORAGE' | 'EMPLOYEES' | 'INFRASTRUCTURE' | 'IT' | 'LOGGING' | 'MONITORING_ALERTS' | 'PEOPLE' | 'POLICIES' | 'RISK_ANALYSIS' | 'SECURITY_ALERT_MANAGEMENT' | 'SOFTWARE_DEVELOPMENT' | 'VENDORS' | 'VULNERABILITY_MANAGEMENT'

Categories for tests.

Filter tests by category.

isInRolloutboolean

Filter tests by rollout status. A test in rollout is an upcoming test that does not have its history tracked yet.

Response

Ok