risks

Get a list of questionnaire risks for one or more watched vendors or a specific questionnaire

Returns a list of currently open questionnaire risks for one or more of an account's watched vendors. Please note this version of the endpoint has been deprecated, and v2 should be used instead.

Required API key permissions: VendorRisk (select when creating API key in Account Settings)

get/risks/vendors/questionnaires

Request

Query parameters

vendor_idinteger

Restricts the questionnaire risks returned to a specific watched vendor by ID

primary_hostnamestring

Restricts the questionnaire risks returned to a specific watched vendor by vendor primary hostname

questionnaire_idinteger

Restricts the questionnaire risks returned to a specific questionnaire by ID

page_tokenstring

The token of the page to be returned. Will return the first page if left blank.

page_sizeinteger

The number of risks to return per page. This Integer between 10 and 2000 defaults to 1000 if not supplied.

Response

Questionnaire risks for specific watched vendors or questionnaire instances

next_page_tokenstring

The token to be used to retrieve the next page of results. Will not be returned if there are no more results.

total_resultsinteger

The total number of risks found.

Example response

{
  "next_page_token": "4",
  "risks": [
    {
      "createdAt": "2022-03-20T23:25:26.419947Z",
      "questionnaireId": 4,
      "riskAdjustedSeverity": "medium",
      "riskCategory": "secprog",
      "riskId": "warn_secprog_nopolicies",
      "riskName": "Inadequate security policies",
      "riskSeverity": "low",
      "riskText": "Security policies are an important tool for establishing authoritative security requirements and enforcing them throughout the company. Policies form the basis of any security program.",
      "vendorId": 123456789
    }
  ],
  "total_results": 10
}

Changes

No recorded changes to this operation across all 2 revisions of this API.