POST: Company Threat Attestations Query

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

List all the company’s threat attestations

Parameters

See query parameters for details on the following parameters:

• limit (Default: ↻ 100)
• offset
• sort
• fields

* required

guid*

[Path] The company's unique identifier

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

threat.guid

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

Value: [Array] List of threat unique identifier(s)

is_public

[Body] Filter by public or private attestations.

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

is_latest

[Body] 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

[Body] Filter by attestation slug.

Value: [Array] List of attestation slugs (UNREVIEWED, UNDER_REVIEW, NOT_VULNERABLE, RISK_ACCEPTED)

created_by.guid

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

Value: [Array] List of the creator’s unique identifier(s)

created_time

[Body] Filter by created time equal to the value

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

created_time_lt

[Body] Filter by created time less than the value

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

created_time_lte

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

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

created_time_gt

[Body] Filter by created time greater than the value

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

created_time_gte

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

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

Example Response

{

"links": {

"next": null,

"previous": null

},

"count": 1,

"results": [

{

"threat": {

"guid": "11111111-aaaa-1111-aaaa-111111111111",

"name": "CVE-2025-XXXX"

},

"attestation": {

"slug": "UNDER_REVIEW",

"name": "Under Review"

},

"is_public": false,

"is_latest": true,

"created_time": "2025-08-03T11:46:59.964838Z",

"created_by": {

"guid": "1a1a1a1a-a1a1-1a1a-a1a1-1a1a1a1a1a1a",

"name": "User Name"

}

}

]

}

Response Attributes