Vendor Criteria are the reusable assessment criteria evaluated during a Vendor Security Review. Each criterion carries a type, a severity, the vendor types it applies to (empty means all), and an optional questionnaire file.
Find vendor assessment criteria matching the provided filters.
🔒 Requires Vendors: List Vendor Criteria permission.
💎 Requires your account have the TPRM Agentic Assessment, AI Data Share feature. Contact your Account Manager for help upgrading.
🔒 Requires the company's AI features setting turned on. Otherwise it returns 403 AI_FORBIDDEN.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action AI features are not enabled for this account.
No security review exists with the given securityReviewId
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "name": "Data Security Criteria",
- "description": [
- "The vendor has designated security personnel"
], - "source": "Drata default",
- "type": "DEFAULT",
- "severity": "HIGH",
- "isDraft": false,
- "vendorTypes": [
- {
- "id": 3,
- "name": "Cloud Provider"
}
], - "impactLevels": [
- {
- "impactLevel": "CRITICAL",
- "vendorRiskLevelId": 14
}
], - "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "questionnaireFile": {
- "id": 1,
- "name": "Security Policy Document"
}, - "questionnaireFileId": null
}
], - "pagination": {
- "cursor": "string",
- "totalCount": 0
}
}Create a custom Vendor Criterion with its Severity, the inherent Risk levels it is assessed at and, optionally, the Vendor Types it applies to.
🔒 Requires Vendors: Create Vendor Criterion permission.
💎 Requires your account have the TPRM Agentic Assessment, AI Data Share feature. Contact your Account Manager for help upgrading.
🔒 Requires the company's AI features setting turned on. Otherwise it returns 403 AI_FORBIDDEN.
Created
The body is invalid, or a vendorRiskLevelIds or vendorTypeIds entry is not an active Risk level or Vendor Type of the account.
Invalid Authorization
You must upgrade your plan to use this feature
The caller lacks the required permission or OAuth scope, or the account reached its Vendor Criteria limit. AI features are not enabled for this account.
Another Vendor Criterion is being created for the account at the same time. Retry the request.
You must accept the Drata terms and conditions to use the API
Internal server error
{- "name": "Data Security",
- "description": "Evaluate the Vendor data security practices and compliance.",
- "vendorRiskLevelIds": [
- 1,
- 2
], - "severity": "HIGH",
- "vendorTypeIds": [
- 4
], - "isDraft": false
}{- "id": 1,
- "name": "Data Security Criteria",
- "description": [
- "The vendor has designated security personnel"
], - "source": "Drata default",
- "type": "DEFAULT",
- "severity": "HIGH",
- "isDraft": false,
- "vendorTypes": [
- {
- "id": 3,
- "name": "Cloud Provider"
}
], - "impactLevels": [
- {
- "impactLevel": "CRITICAL",
- "vendorRiskLevelId": 14
}
], - "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "questionnaireFile": {
- "id": 1,
- "name": "Security Policy Document"
}, - "questionnaireFileId": null
}Return a Vendor Criterion with its Vendor Types and impact levels.
🔒 Requires Vendors: Get Vendor Criterion permission.
💎 Requires your account have the TPRM Agentic Assessment, AI Data Share feature. Contact your Account Manager for help upgrading.
🔒 Requires the company's AI features setting turned on. Otherwise it returns 403 AI_FORBIDDEN.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action AI features are not enabled for this account.
No Vendor Criterion exists with the given criterionId.
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "name": "Data Security Criteria",
- "description": [
- "The vendor has designated security personnel"
], - "source": "Drata default",
- "type": "DEFAULT",
- "severity": "HIGH",
- "isDraft": false,
- "vendorTypes": [
- {
- "id": 3,
- "name": "Cloud Provider"
}
], - "impactLevels": [
- {
- "impactLevel": "CRITICAL",
- "vendorRiskLevelId": 14
}
], - "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "questionnaireFile": {
- "id": 1,
- "name": "Security Policy Document"
}, - "questionnaireFileId": null
}Update the given fields of a Vendor Criterion; omitted fields keep their value. A body with no field returns 204 and changes nothing.
🔒 Requires Vendors: Update Vendor Criterion permission.
💎 Requires your account have the TPRM Agentic Assessment, AI Data Share feature. Contact your Account Manager for help upgrading.
🔒 Requires the company's AI features setting turned on. Otherwise it returns 403 AI_FORBIDDEN.
Successful
No Content
The body is invalid, or a vendorRiskLevelIds or vendorTypeIds entry is not an active Risk level or Vendor Type of the account.
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action AI features are not enabled for this account.
No Vendor Criterion exists with the given criterionId.
You must accept the Drata terms and conditions to use the API
Internal server error
{- "name": "Data Security",
- "description": "Evaluate the Vendor data security practices and compliance.",
- "vendorRiskLevelIds": [
- 1,
- 2
], - "severity": "HIGH",
- "vendorTypeIds": [
- 4
]
}{- "id": 1,
- "name": "Data Security Criteria",
- "description": [
- "The vendor has designated security personnel"
], - "source": "Drata default",
- "type": "DEFAULT",
- "severity": "HIGH",
- "isDraft": false,
- "vendorTypes": [
- {
- "id": 3,
- "name": "Cloud Provider"
}
], - "impactLevels": [
- {
- "impactLevel": "CRITICAL",
- "vendorRiskLevelId": 14
}
], - "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "questionnaireFile": {
- "id": 1,
- "name": "Security Policy Document"
}, - "questionnaireFileId": null
}Soft delete a Vendor Criterion.
🔒 Requires Vendors: Delete Vendor Criterion permission.
💎 Requires your account have the TPRM Agentic Assessment, AI Data Share feature. Contact your Account Manager for help upgrading.
🔒 Requires the company's AI features setting turned on. Otherwise it returns 403 AI_FORBIDDEN.
No Content
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action AI features are not enabled for this account.
No Vendor Criterion exists with the given criterionId.
You must accept the Drata terms and conditions to use the API
Internal server error
{- "name": "string",
- "statusCode": 0,
- "message": "string",
- "code": 0
}