GET: Company Threat Attestations Summaries

https://api.bitsighttech.com/ratings/v1/companies/{guid}/threats/attestations/summaries

Summarized threat attestations data for a company

Parameters

* required

guid*

[Path] The company's unique identifier

Value: [String] Company unique identifier [company_guid].

threat.guid

[Query] Filter by threat unique identifier(s).

Value: [String] Comma-separated list of threat unique identifier(s)

is_public

[Query] Filter by public or private attestations.

Value: [Boolean] Determines whether public (true) or private (false) attestations are displayed.

is_latest

[Query] Filter by the latest attestation per threat.

Value: [Boolean] When true, only the most recent attestations per threat are displayed. When false, all attestations except the most recent are shown.

attestation.slug

[Query] Filter by attestation slug.

Value: [String] Comma-separated list of attestation slugs (UNREVIEWED, UNDER_REVIEW, NOT_VULNERABLE, RISK_ACCEPTED)

created_by.guid

[Query] Filter by the created by unique identifier(s). Only available with EASM Enhanced.

Value: [String] Comma-separated list of the creator’s unique identifier(s)

created_time

[Query] Filter by created time equal to the value

Value: [String] ISO 8601 datetime [YYYY-MM-DDTHH:MM:SSZ]. 

created_time_lt

[Query] Filter by created time less than the value

Value: [String] ISO 8601 datetime [YYYY-MM-DDTHH:MM:SSZ]. 

created_time_lte

[Query] Filter by created time less than or equal to the value

Value: [String] ISO 8601 datetime [YYYY-MM-DDTHH:MM:SSZ]. 

created_time_gt

[Query] Filter by created time greater than the value

Value: [String] ISO 8601 datetime [YYYY-MM-DDTHH:MM:SSZ]. 

created_time_gte

[Query] Filter by created time greater than or equal to the value

Value: [String] ISO 8601 datetime [YYYY-MM-DDTHH:MM:SSZ]. 

Example Response

{

  "attestations": [

    {

      "slug": "UNREVIEWED",

      "threat_guids": [

        "11111111-bbbb-1111-bbbb-111111111111"

      ]

    },

    {

      "slug": "UNDER_REVIEW",

      "threat_guids": [

        "11111111-aaaa-1111-aaaa-111111111111"

      ]

    }

  ]

}

Response Attributes