POST: Threat Attestations Query

https://api.bitsighttech.com/ratings/v1/threats/attestations/query

List all the threat attestations

Parameters

See query parameters for details on the following parameters:

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

company.guid

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

attestation.slug

[Body] Filter by attestation slug.

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

folder

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

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

tier

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

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

scope

[Body] Filter by companies’ scope

Value: [String] Possible values: spm, tprm

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"

},

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

"company": {

"guid": "feeccea4-e062-4cf5-9a3d-7034addb12d1",

"name": "Blue Seas International"

}

}

]

}

Response Attributes