Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

GET: Peer Group Information

Avatar
Ingrid
Follow
Publication Date – April 27, 2022

⇤ Companies

https://api.bitsighttech.com/ratings/v1/companies/entity_guid/peer-analytics/peer-group/count

Get your peer group information.

Parameters

*Required.

Parameter Description Values 
employee_size
Query		 Filter peers by employee size. [String]
  • any
  • similar
 
entity_guid
Path		 Identify the company to query. [String] Company unique identifier [entity_guid]. See GET: Portfolio Details. 
industry_slugs
Query		 Filters peers by industry. [String] Industry slug name. See GET: Portfolio Summary. 
rating_gte
Query		 Filter peers by a minimum rating. [Integer] A rating between 300 and 820 as the minimum in the range. 
rating_lte
Query		 Filter peers by a maximum rating. [Integer] A rating between 300 and 820 as the maximum in the range. 
service_size
Query		 Filter peers by service size. [String]
  • any
  • similar
 
sub_industry_slugs
Query		 Filter peers by sub-industry. If set, this overrides the industry parameter. [String] Sub-industry slug name. See industries.

Example Request

curl https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/peer-analytics/peer-group/count -u api_token:

Example Response

{
  "company_guid":"a940bb61-33c4-42c9-9231-c8194c305db3",
  "peer_group":{
    "industry_slugs":[
      "technology"
    ],
    "employee_count_gte":0,
    "employee_count_lte":0
  },
  "peer_count":76269
}

Response Attributes

Field Description 
company_guid
String [entity_guid]		 The queried company’s unique identifier. 
peer_group
Object		 Peer group information.
  
industry_slugs
Array		 Industries in this peer group. 
employee_count_gte
Integer		 The lowest number of a peer’s employees. 
employee_count_lte
Integer		 The highest number of a peer’s employees. 
peer_count
Integer		 The number of peers in this peer group.

Status Codes

Code Description
200 – Okay Everything worked as expected.
400 – Bad Data This can often be due to missing a required parameter.
401 – Unauthorized No valid API token was provided.
403 – Permission Denied You do not have permission to access this resource.
404 – Not Found The specified resource does not exist.

Related articles