Vendor Criteria

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.

List Vendor Criteria

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.

Securitybearer or oauth2
Request
query Parameters
cursor
string

This parameter is used to paginate through results. No value is needed for the first request. If there are additional results, the response will contain a pagination.cursor value that can be used in the subsequent request to retrieve the next page of results

size
number [ 1 .. 500 ]
Default: 50

Number of results to return

sort
string (SortTypeLimitedEnum)

Which field to sort by

Enum: "createdAt" "updatedAt"
sortDir
string (SortDirectionEnum)

The direction to sort the data

Enum: "ASC" "DESC"
includeTotalCount
boolean

Include total count of all matching records in response. Only honored on first page (when cursor is null).

Example: includeTotalCount=false
name
string

Filters by name prefix match: returns rows whose name starts with this text.

Example: name=security
impactLevels[]
Array of strings (VendorImpactLevelLabelsEnum)

Filter Criteria by impact level. Accepts: INSIGNIFICANT, MINOR, MODERATE, MAJOR, CRITICAL, UNSCORED.

Items Enum: "INSIGNIFICANT" "MINOR" "MODERATE" "MAJOR" "CRITICAL" "UNSCORED"
vendorRiskLevelIds[]
Array of numbers <= 300 items

Filter Criteria by Vendor Risk Level ID

Example: vendorRiskLevelIds[]=1&vendorRiskLevelIds[]=2
vendorTypeIds[]
Array of numbers <= 300 items

Filter Criteria by Vendor Type ID

Example: vendorTypeIds[]=1&vendorTypeIds[]=2
isDraft
boolean

Filter Criteria by draft status

Example: isDraft=false
securityReviewId
number

Filter Criteria by Security Review ID: returns the Criteria selected for this Security Review. When none have been selected, returns the Criteria the review will assess, chosen from the Vendor's impact level, risk level and Vendor Type; those are always published, so pairing this with isDraft=true returns no rows. Returns 404 when the Security Review does not exist.

Example: securityReviewId=123
criterionTypes[]
Array of strings (VendorAssessmentCriterionTypeEnum)

Filter Criteria by type. Accepts: CUSTOM, DEFAULT, AI_GENERATED.

Items Enum: "CUSTOM" "DEFAULT" "AI_GENERATED"
severities[]
Array of strings (VendorAssessmentCriterionSeverityEnum)

Filter Criteria by severity. Accepts: LOW, MEDIUM, HIGH.

Items Enum: "LOW" "MEDIUM" "HIGH"
expand[]
Array of strings (VendorCriteriaExpandEnum)

List of sub-objects to expand

Items Enum: "vendorTypes" "impactLevels" "questionnaireFile"
Responses
200

Successful

400

Malformed data and/or validation errors

401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action AI features are not enabled for this account.

404

No security review exists with the given securityReviewId

412

You must accept the Drata terms and conditions to use the API

500

Internal server error

get/vendor-criteria
Request samples
Response samples
application/json
{
  • "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 Vendor Criterion

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.

Securitybearer or oauth2
Request
Request Body schema: application/json
required
name
required
string [ 3 .. 191 ] characters

The Criterion name.

description
required
string [ 3 .. 30000 ] characters

The Criterion description, stored as a single paragraph of the description array the Criterion returns.

vendorRiskLevelIds
required
Array of numbers

The IDs of the inherent Risk levels the Criterion is assessed at. An empty array creates the Criterion without a Risk level.

severity
string or null

The Severity of a gap on the Criterion. Omit it or send null to leave it unset.

Enum: "LOW" "MEDIUM" "HIGH"
vendorTypeIds
Array of numbers

The IDs of the Vendor Types the Criterion applies to. Omit it or send an empty array to apply the Criterion to every Vendor Type.

isDraft
boolean
Default: false

Whether to create the Criterion as a draft instead of publishing it.

Responses
201

Created

400

The body is invalid, or a vendorRiskLevelIds or vendorTypeIds entry is not an active Risk level or Vendor Type of the account.

401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

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.

409

Another Vendor Criterion is being created for the account at the same time. Retry the request.

412

You must accept the Drata terms and conditions to use the API

500

Internal server error

post/vendor-criteria
Request samples
application/json
{
  • "name": "Data Security",
  • "description": "Evaluate the Vendor data security practices and compliance.",
  • "vendorRiskLevelIds": [
    • 1,
    • 2
    ],
  • "severity": "HIGH",
  • "vendorTypeIds": [
    • 4
    ],
  • "isDraft": false
}
Response samples
application/json
{
  • "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
}

Get Vendor Criterion

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.

Securitybearer or oauth2
Request
path Parameters
criterionId
required
number

The numeric ID of the Vendor Criterion.

Responses
200

Successful

400

Malformed data and/or validation errors

401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action AI features are not enabled for this account.

404

No Vendor Criterion exists with the given criterionId.

412

You must accept the Drata terms and conditions to use the API

500

Internal server error

get/vendor-criteria/{criterionId}
Request samples
Response samples
application/json
{
  • "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 Vendor Criterion

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.

Securitybearer or oauth2
Request
path Parameters
criterionId
required
number

The numeric ID of the Vendor Criterion.

Request Body schema: application/json
required
name
string [ 3 .. 191 ] characters

The new Criterion name. Omit it to keep the current one.

description
string [ 3 .. 30000 ] characters

The new Criterion description, stored as a single paragraph of the description array the Criterion returns. Omit it to keep the current one.

vendorRiskLevelIds
Array of numbers

The IDs of the inherent Risk levels the Criterion is assessed at, replacing the current ones. Omit it to keep them; send an empty array to clear them.

severity
string or null

The new Severity of a gap on the Criterion. Omit it to keep the current one; send null to clear it.

Enum: "LOW" "MEDIUM" "HIGH"
vendorTypeIds
Array of numbers

The IDs of the Vendor Types the Criterion applies to, replacing the current ones. Omit it to keep them; send an empty array to apply the Criterion to every Vendor Type.

Responses
200

Successful

204

No Content

400

The body is invalid, or a vendorRiskLevelIds or vendorTypeIds entry is not an active Risk level or Vendor Type of the account.

401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action AI features are not enabled for this account.

404

No Vendor Criterion exists with the given criterionId.

412

You must accept the Drata terms and conditions to use the API

500

Internal server error

put/vendor-criteria/{criterionId}
Request samples
application/json
{
  • "name": "Data Security",
  • "description": "Evaluate the Vendor data security practices and compliance.",
  • "vendorRiskLevelIds": [
    • 1,
    • 2
    ],
  • "severity": "HIGH",
  • "vendorTypeIds": [
    • 4
    ]
}
Response samples
application/json
{
  • "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
}

Delete Vendor Criterion

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.

Securitybearer or oauth2
Request
path Parameters
criterionId
required
number

The numeric ID of the Vendor Criterion.

Responses
204

No Content

400

Malformed data and/or validation errors

401

Invalid Authorization

402

You must upgrade your plan to use this feature

403

You are not allowed to perform this action AI features are not enabled for this account.

404

No Vendor Criterion exists with the given criterionId.

412

You must accept the Drata terms and conditions to use the API

500

Internal server error

delete/vendor-criteria/{criterionId}
Request samples
Response samples
application/json
{
  • "name": "string",
  • "statusCode": 0,
  • "message": "string",
  • "code": 0
}