API Fields: Rating Types Ingrid To best manage risk, using the Bitsight-curated version in your portfolio rather than the self-published rating is suggested. However, your approach may vary depending on your relationships with the companies in your portfolio. Bitsight Curated Self-Published Privately Published Bitsight Curated Bitsight-curated is the default designation. Path Purpose Field Value /v1/companies/company_guid/company-tree GET: Ratings Tree rating_type CURATED /v2/portfolio GET: Portfolio Details type CURATED /v1/portfolio GET: Portfolio Details [V1] type CURATED /v1/subscriptions/expired GET: Expired Subscriptions type CURATED Self-Published Self-published ratings have their own Bitsight Security Rating reports, which consist of CIDR blocks, IP addresses, and domains that are specifically selected by the company itself, rather than curated by Bitsight. To return all self-published companies, you must also include the PRIVATE value. Privately published companies are self-published companies, but are labeled and filtered differently by the API. To return only self-published, publicly visible companies, use only the SELF-PUBLISHED value. Path Purpose Field Value /v1/companies/company_guid/company-tree GET: Ratings Tree rating_type SELF_PUBLISHED /v2/portfolio GET: Portfolio Details type SELF_PUBLISHED /v1/portfolio GET: Portfolio Details [V1] type SELF_PUBLISHED /v1/subscriptions/expired GET: Expired Subscriptions type SELF_PUBLISHED Privately Published Privately published ratings are created by an organization for internal use and are not available for other organizations to monitor and do not appear in searches by other organizations. Path Purpose Field Value /v1/companies/company_guid/company-tree GET: Ratings Tree rating_type PRIVATE /v2/portfolio GET: Portfolio Details type PRIVATE /v1/portfolio GET: Portfolio Details [V1] type PRIVATE /v1/subscriptions/expired GET: Expired Subscriptions type PRIVATE May 26, 2021: Added GET: Ratings Tree (/v1/companies/{company_guid}/company-tree) to related endpoints. November 25, 2020: Published. Related articles API Fields: Risk Types POST: Custom ID in Bulk GET: Portfolio Details Bitsight Curated Ratings GET: Ratings History Feedback 0 comments Please sign in to leave a comment.