GET: Ratings Graph Data of a Folder – Bitsight Knowledge Base

Publication Date – July 2, 2020

https://api.bitsighttech.com/ratings/v1/folders/folder_guid/graph_data

Get the ratings graph data of a folder.

Parameters

*Required.

Parameter	Description	Values
folder_guid Path	Identify the folder to query.	[String] Folder unique identifier [`folder_guid`]. See GET: Folder Details.

curl https://api.bitsighttech.com/ratings/v1/folders/folder_guid/graph_data -u api_token:

{
  "name":"My Folder",
  "ratings":[
    {
      "y":690,
      "x":"2020-06-28"
    }
  ]
}

Field			Description
name String			The name of the folder.
ratings Array			The rating information for the graph.
	Object		Graph data.
		y Integer	The median Bitsight Security Rating of the companies in the folder, as displayed in the vertical axis of the graph.
		x String [`YYYY‑MM‑DD`]	The date when the median rating of companies in the folder were established, as displayed in the horizontal axis of the graph.