Skip to main content
Security Performance Management
Continuous Monitoring
Vendor Risk Management
Trust Management Hub
Cyber Insurance
National Cybersecurity

POST: Download Report

Ingrid

⇤ Endpoints

https://api.bitsighttech.com/ratings/v1/reports

Download either of the following reports:

Parameters

* Required.

Parameter Values 
params

* [Body] Identify the company to query.

 [Object]
  
company

* [Body] Identify the company to generate a Company Overview report.

 [String] Company unique identifier [entity_guid]. See GET: Portfolio Details. 
guid

* [Body] Identify the company to generate an Executive report.

 
report_template

[Body] Identify the report to download.

[String] Report unique identifier [report_guid].

  • ↻ Company Overview (default)
  • Executive = d1100906-2653-4d80-8cb2-c95b3cf87546 
output

* [Query] Identify the location to save the downloaded file, assign a name, and type of file.

 [String] The path in your directory.

Example Company Overview Request

cURL Example

curl -X POST https://api.bitsighttech.com/ratings/v1/reports -u api_token: -H "Content-Type: application/json" -d '{"params": {"company": "a940bb61-33c4-42c9-9231-c8194c305db3"}"}' --output downloads/filename.pdf

JSON Example

{
  "params": {
    "company": "a940bb61-33c4-42c9-9231-c8194c305db3"
  }
}

Example Executive Request

cURL Example

curl -X POST https://api.bitsighttech.com/ratings/v1/reports -u api_token: -H "Content-Type: application/json" -d '{"params": {"guid": "a940bb61-33c4-42c9-9231-c8194c305db3"},"report_template": "d1100906-2653-4d80-8cb2-c95b3cf87546"}' --output downloads/filename.pdf

JSON Example

{
  "params": {
    "guid": "a940bb61-33c4-42c9-9231-c8194c305db3"
  },
  "report_template": "d1100906-2653-4d80-8cb2-c95b3cf87546"
}

Example Response

The download status is displayed. If successful, the file is downloaded to the identified folder in your directory.

  • December 20, 2024: company parameter for the overview report and guid parameter for the executive report.
  • May 24, 2024: Parameter for specifying a report.
  • February 26, 2020: Published.

Related articles

Feedback

2 comments

Date Votes
  • Jeffery Malson

    I can't get the default Company Overview report to download.  If I omit the report template I get Detail: Not found.   Any suggestions on how I can get it to work?

    0
  • Ingrid

    Detail: Not found is the same as the 404 Not found status code, which means “The specified resource could not be found.” If you're using cURL, have you included the required entity_guid parameter and identified where to download the file with --output {The path in your directory}?

    0

Please sign in to leave a comment.