v1

latestOpenAPI 3.1.12026-07-242899061.7 MB

Alerts

This resource returns Alerting Issues from new scans in their portfolio based on the users alert settings.

This resource returns Alerting Issues from new scans in their portfolio based on the users alert settings. Alert settings can be changed at https://portal.riskrecon.com/portal/alert-center/alert-settings.

get/v1/alerting/issues

Query parameters

pageinteger

Example:1

This parameter is the page number in routes that have pagination.

per_pageinteger

Example:20

This parameter sets the results limit per page. This defaults to 20 and currently has a max of 50.

sort_method'ASC' | 'DESC'

Example:DESC

Sort results by ascending or descending order.

start_datestring date

Filter results after the provided date string in format YYYY-MM-DD. Can't search back further than 1 month.

end_datestring date

This parameter filters results before the provided date string in format YYYY-MM-DD. Defaults to current date. Must be after start_date.

priorities[]integer[]

Filter findings based on priority. Priority is based on asset_value and severity.

[
  5
]

sort_attribute'priority' | 'last_seen' | 'security_criteria'

Example:last_seen

This parameter is optional but allows the user to sort results of alerting issues by available sort attributes.

Response

Example response

{
  "meta": {
    "current_page": 2,
    "next_page": 3,
    "prev_page": 1,
    "total_count": 52,
    "total_pages": 10,
    "total_new": 37
  },
  "issue_alerts": [
    {
      "id": "5976423a-ee35-11e3-8569-14109ff1a304",
      "toe_id": "5976423a-ee35-11e3-8569-14109ff1a304",
      "internal_id": [
        "1234"
      ],
      "new": true,
      "seen": true,
      "company_name": "Riskrecon, Co.",
      "security_domain_key": "software_patching",
      "security_criteria_key": "patching_app_server",
      "risk_structure": "Uncategorized",
      "analysis_id": "15",
      "date": "2023-01-03",
      "first_seen": "2023-01-03",
      "finding_id": "5976423a-ee35-11e3-8569-14109ff1a304",
      "issue": "Missing Security Headers",
      "finding_context": "The domain is missing one or more domain hijacking flags (clientTransferProhibited, clientDeleteProhibited, clientUpdateProhibited).",
      "asset_value": "high",
      "priority": 5,
      "severity": "critical",
      "host_name": "riskrecon.com",
      "ip_address": "40.14.1.146",
      "domain_name": "thiel.name"
    }
  ]
}