Welcome
Integrating with REST API
External systems integration is one of the key features of BigFix Inventory. Business logic is enabled for integration and interfaces are provided for common integration points.
REST API
Managing large amounts of information by using the application user interface can be time-consuming. You can use the REST APIs as an alternative to the graphical user interface to reduce the time that is needed to manage your software inventory and the content of your software catalog.
Historical APIs
For some REST APIs, version 2 is created to provide improved functions or experience. In such cases, the original API is deprecated and version 2 is supported. You must adjust your custom tools or internal processes to the new version of these APIs.
REST API for retrieving computer systems, clusters, software instances, and license usage
You can use this REST API to quickly retrieve large amounts of data related to your computer systems, clusters, software instances, and license usage. Once the data is retrieved, it can be passed to other applications for further processing and analysis.

BigFix Documentation Homepage
BigFix 11 Inventory Documentation
Welcome to the BigFix Inventory documentation, where you can find information about how to install and configure BigFix Inventory. The application provides you with information about your inventory and license metrics. You can manage your software assets, gather information about your hardware, and ensure license compliance for your enterprise using BigFix Inventory.
BigFix Platform
Overview
Become familiar with key concepts that are necessary to understand how BigFix Inventory works and learn about features and functions that are introduced in every version of the application.
Installing
Learn about the requirements and available installation scenarios to ensure that the deployment of BigFix Inventory goes smoothly in your environment.
Configuring
After you install BigFix Inventory, configure the application. Create accounts for the users who need access to the application and set up scans to collect software and hardware inventory data from your environment.
Upgrading
A new version of BigFix Inventory is released periodically, typically at the end of each calendar quarter. Upgrade to the new version regularly to take full advantage of new features and application fixes.
Catalog Overview
This section provides information about catalog updates available with every release.
Managing the infrastructure
After you complete the initial configuration of BigFix Inventory, learn how to manage components of its infrastructure: VM managers, server, database, and data sources.
Software inventory and license utilization
You can classify the discovered software so that reports in BigFix Inventory reflect your entitlements and properly show utilization of license metrics by particular products.
Managing security threats
Learn how to use BigFix Inventory to manage security threats in your environment. You can view whether any of the installed components is prone to any Common Vulnerability and Exposure (CVE).
Tutorials
Tutorials help you understand how to use BigFix Inventory. They consist of modules that focus on broad goals. Modules consist of tasks that show how to configure specific settings step-by-step.
Security
Configure different security features to adequately protect business assets and resources in the data model when using BigFix Inventory.
Troubleshooting and support
Learn about solutions to common problems that might arise when you use BigFix Inventory BigFix Inventory and how to find logs and trace files that help you troubleshoot those problems.
Tuning performance
Learn how to plan the infrastructure of BigFix Inventory and to configure the application server to achieve optimal performance. The following guidelines are applicable in big data environments as well as in smaller environments that are running on low-performance hardware.
Integrating with REST API
External systems integration is one of the key features of BigFix Inventory. Business logic is enabled for integration and interfaces are provided for common integration points.
- REST API
  Managing large amounts of information by using the application user interface can be time-consuming. You can use the REST APIs as an alternative to the graphical user interface to reduce the time that is needed to manage your software inventory and the content of your software catalog.
  - Software Products and Software Components
    BigFix Inventory detects software components which are bundled with the product.
  - REST API resources and HTTP methods
    The operations of the BigFix Inventory REST API protocol are defined as HTTP methods on certain REST resources.
  - Common REST API elements
    You use connectors and operators to build query segments that filter on matching conditions and values.
  - Mapping REST API versions
    Available from 9.2.8. For some REST APIs, version 2 is created to provide improved functions or experience. In such cases, the original API becomes deprecated with time and only version 2 is further developed. If you have custom tools or internal processes that are based on such REST APIs, it is best to adjust the tools to use the new version of the APIs.
  - REST API for retrieving authentication token
    You use the POST operation on the api/get_token element to request your unique token that is required to authenticate the REST API requests.
  - REST API for retrieving the BigFix Inventory version
    You use the GET operation on the api/sam/about element to request information about the version of BigFix Inventory.
  - Core APIs
    Core APIs include all primary set of APIs that are integrated with BigFix Inventory.
  - Configuration APIs
    Configuration APIs include all APIs that you need to configure the application.
  - Historical APIs
    For some REST APIs, version 2 is created to provide improved functions or experience. In such cases, the original API is deprecated and version 2 is supported. You must adjust your custom tools or internal processes to the new version of these APIs.
    - REST API for retrieving computer systems, clusters, software instances, and license usage
      You can use this REST API to quickly retrieve large amounts of data related to your computer systems, clusters, software instances, and license usage. Once the data is retrieved, it can be passed to other applications for further processing and analysis.
      - Scenarios
        Choose one of the scenarios to learn how to determine the license usage for all of your computer systems or only for the selected ones. The first approach is recommended if you want to retrieve your data in bulk and calculate the license usage for the whole environment. The second one, however, allows you to quickly target specific information by retrieving data for a chosen subset of computer systems.
      - Retrieval of computer systems
        You use the GET operation on the api/sam/computer_systems element to request information about computer systems in your infrastructure.
      - Retrieval of clusters
        You use the GET operation on the api/sam/clusters element to request information about clusters that group your host computer systems. This information represents the current state of your environment and does not include any historical data.
      - Retrieval of software instances
        You use the GET operation on the api/sam/software_instances element to request information about software installed in your infrastructure.
      - Retrieval of license usage
        You use the GET operation on the api/sam/license_usages element to request information about license usage reported by your computer systems.
    - REST API for software inventory management
      You can reduce the time needed to manage your software inventory in a large environment by using REST API instead of the application user interface. You can use REST API to get a list of software products, releases, and release instances. You can also find out how your software can be bundled.
    - REST API for software classification
      You can reduce the time that is needed to manage your software instances in a large environment by using REST API instead of the application user interface. You can use REST API to share instances, include or exclude instances from a pricing calculation, confirm and assign instances, and reassign instances.
Glossary
Guide in PDF format

REST API for retrieving computer systems, clusters, software instances, and license usage

You can use this REST API to quickly retrieve large amounts of data related to your computer systems, clusters, software instances, and license usage. Once the data is retrieved, it can be passed to other applications for further processing and analysis.

The following image represents the relations between all resources included in this REST API:

Relations between the resources of this REST API