https://api.bitsighttech.com/ratings/v1/companies
This endpoint returns several informational keys, an array of objects (each of which contains details about a company in your portfolio), and an optional quick reference to the unique identifier of company, if it has a “My Company” set.
Use GET: Portfolio Details to get information about the companies in your portfolio.
Example Request
curl https://api.bitsighttech.com/ratings/v1/companies -u api_token:
Example Response
{ "my_company": { "guid": "b940aa61-42c9-33c4-9233-d8194c305db3" }, "companies": [ { "guid": "8c87c257-6767-42ad-8369-c4c5833851d4", "custom_id": "abc-123", "name": "Teacup Demolition Corp.", "shortname": "TDCorp", "network_size_v4": 0, "rating": 710, "rating_date": "2020-02-04", "date_added": "2014-11-03", "industry": "Engineering", "industry_slug": "engineering", "sub_industry": "Construction", "sub_industry_slug": "construction", "type": "CURATED", "logo": "https://api.bitsighttech.com/ratings/v1/companies/8c87c257-6767-42ad-8369-c4c5833851d4/logo-image", "sparkline": "https://api.bitsighttech.com/ratings/v1/companies/8c87c257-6767-42ad-8369-c4c5833851d4/sparkline?size=small", "external_id": 1710001246, "subscription_type": "Total Risk Monitoring", "subscription_type_key": "continuous_monitoring", "primary_domain": "teacupdemo.com", "security_grade": null, "grade_date": null, "display_url": "https://service.bitsighttech.com/app/company/companies/8c87c257-6767-42ad-8369-c4c5833851d4/overview", "href": "https://api.bitsighttech.com/ratings/v1/companies/de33c445-7619-4935-b1d6-e6c5b9a6b834" } ], "rating_date": "2014-11-10", "created": "2012-10-31" }
Response Attributes
Field | Description | |
---|---|---|
my_company Object |
Details of your company. | |
guid String [ |
Your organization's company unique identifier. If your organization has not purchased monitoring for its own company, this field and the my_company object will not be returned by the API server. |
|
companies Array |
Details of companies within your portfolio of no particular order. | |
guid String [ |
The unique identifier of this company. | |
custom_id String |
The customizable ID assigned to this company. | |
name String |
The name of this company. | |
shortname String |
The abbreviated name of this company. | |
network_size_v4 Integer |
The number of IPv4 addresses attributed to this company. | |
rating Integer |
The most recent security rating of this company. | |
rating_date String [ |
The date when the rating report for this company was generated. | |
date_added String [ |
The date when this company was added to your portfolio. | |
industry String |
The industry of this company. | |
industry_slug String |
The slug name of this company's industry. | |
industry_slug String |
The sub-industry of this company. | |
sub_industry_slug String |
The slug name of this company's sub-industry. | |
type String |
The rating type. | |
logo String |
The URL in the Bitsight platform to this company's logo image. | |
sparkline String |
The URL in the Bitsight platform to this company's historical ratings trend line. | |
external_id Integer |
For internal Bitsight use. | |
subscription_type String |
The subscription type used to monitor this company. | |
subscription_type_key String |
The slug name of the subscription type used to monitor this company. | |
primary_domain String |
The primary domain of this company. | |
security_grade Null |
For internal Bitsight use. | |
grade_date Null |
For internal Bitsight use. | |
display_url String |
The URL in the Bitsight platform to this company's overview page. | |
href String |
The URL in the Bitsight platform to this company's page. | |
rating_date String [ |
The most recent date when security ratings were available. | |
created String [ |
The date when your Bitsight account was established. |
-
February 5, 2020: Use the
/portfolio
endpoint to get information about companies in your portfolio.
Feedback
0 comments
Please sign in to leave a comment.