Software
Refer to the Retrieval of software inventory (v2) to know about the BigFix Inventory computers (hardware) API v2.
Example of API request URL used to transfer computers data to ServiceNow:
[BFI_URL]/api/sam/v2/software_instances?token=[FILTERED]&offset=0&limit=100000&order[]=computer_id&criteria={"and":[["is_present","=","1"],["is_suppressed","=","0"],["computer_hardware.status","=","1"],["computer_os_type","!=","MACOS"],["computer_os_type","!=","AIX"]]}&columns[]=instance_id&columns[]=computer_bigfix_id&columns[]=component_name&columns[]=component_release&columns[]=component_detailed_version&columns[]=component_publisher_name&columns[]=is_present&columns[]=discovery_start&columns[]=discovery_end&columns[]=discovery_path&columns[]=computer_id&columns[]=computer_name&columns[]=is_suppressed&columns[]=usage_data.last_used&columns[]=usage_data.total_runs&columns[]=computer_hardware.status&columns[]=computer_hardware.server_model&columns[]=computer_os&columns[]=computer_os_type&columns[]=product_name&columns[]=product_publisher_name&columns[]=product_release_name&columns[]=product_release&columns[]=computer_details.last_seen
Note:
The actual URL will be slightly different as it will be URI
encoded and it will follow ServiceNow formatting. You can review logs of API calls
with their URLs in BigFix Inventory’s tema.log.
Example of API JSON
response:
{
"Output Items": {
"0": {
"component_detailed_version": "2022.160.1000.6",
"component_name": "Microsoft SQL Server for Microsoft SQL Server 2022 Developer Edition",
"component_publisher_name": "Microsoft",
"component_release": "2022.0",
"computer_bigfix_id": 9963821,
"computer_hardware": {
"status": "1"
},
"computer_id": 1,
"computer_last_seen": null,
"computer_name": "WIN-JI9D9AAQL7K",
"computer_os": "Win2022 10.0.20348.1129 (21H2)",
"computer_os_type": "WINDOWS",
"connection_alias_id": "514ca7d21bba9090ff8c75561a4bcbf2",
"discovery_end": "9999-12-31T23:59:59Z",
"discovery_path": [
"C:\\Program Files\\Microsoft SQL Server\\MSSQL16.MSSQLSERVER\\MSSQL\\Binn"
],
"discovery_start": "2025-09-24T03:09:54Z",
"instance_id": 1,
"is_present": true,
"is_suppressed": "0",
"product_name": "Microsoft SQL Server Developer Edition",
"product_publisher_name": "Microsoft",
"product_release": "2022.0",
"product_release_name": "Microsoft SQL Server 2022 Developer Edition",
"usage_data": {
"last_used": "2026-03-04T04:05:36Z",
"total_runs": "9"
}
},
"1": {
"component_detailed_version": "16.0.1000.6",
"component_name": "Microsoft SQL Server Import and Export Data",
"component_publisher_name": "Microsoft",
"component_release": "16.0",
"computer_bigfix_id": 9963821,
"computer_hardware": {
"status": "1"
},
"computer_id": 1,
"computer_last_seen": null,
"computer_name": "WIN-JI9D9AAQL7K",
"computer_os": "Win2022 10.0.20348.1129 (21H2)",
"computer_os_type": "WINDOWS",
"connection_alias_id": "514ca7d21bba9090ff8c75561a4bcbf2",
"discovery_end": "9999-12-31T23:59:59Z",
"discovery_path": [
"C:\\Program Files (x86)\\Microsoft SQL Server\\160\\DTS\\Binn"
],
"discovery_start": "2025-09-24T03:09:54Z",
"instance_id": 13,
"is_present": true,
"is_suppressed": "0",
"product_name": "Microsoft SQL Server Import and Export Data",
"product_publisher_name": "Microsoft",
"product_release": "*",
"product_release_name": "Microsoft SQL Server Import and Export Data",
"usage_data": {
"last_used": null,
"total_runs": "0"
}
}
}
}
API data availability in BigFix Inventory report columns
| BigFix Inventory Computers API | BigFix Inventory UI |
|---|---|
| instance_id | (not available) |
| computer_bigfix_id | Data Source Computer ID |
| component_name | Component Name |
| component_release | Component Version |
| component_detailed_version | Component Detailed Version |
| component_publisher_name | Publisher Name |
| is_present | Present |
| discovery_start | Discovery Start |
| discovery_end | Discovery End |
| discovery_path | Installation Path |
| computer_id | Internal Computer ID |
| computer_name | Computer Name |
| is_suppressed | Suppressed |
| computer_os | Operating System |
| computer_os_type | (not available) |
| product_name | Product Name |
| product_publisher_name | Product Publisher Name |
| product_release_name | Product Name |
| product_release | Product Version |
| computer_hardware.status | Status |
| computer_hardware.server_model | Server Serial Number |
| usage_data.last_used | Last Used |
| usage_data.total_runs | Total Runs |
| computer_details.last_seen | Computer Last Seen |
Software Packages (cmdb_ci_spkg)
| CMDB field name | API field name | ETL transforme |
|---|---|---|
| Discovery source | (value hard coded to SG-BigFix) | |
| First discovered | discovery_start | |
| Key | component_name, component_release | ✓ |
| Manufacturer | component_name, component_release, component_publisher_name | ✓ |
| Name | component_name, component_release, component_publisher_name | ✓ |
| Version | component_name, component_release, component_publisher_name | ✓ |
Software Instances (cmdb_software_instance)
| CMDB field name | API field name | ETL transforme |
|---|---|---|
| Name | component_name, component_release, component_publisher_name, computer_name | ✓ |
| Installed on | (internal computer reference) | |
| Install date | discovery_start | ✓ |
Software installation (cmdb_sam_sw_install)
| CMDB field name | API field name | ETL transforme |
|---|---|---|
| Configuration Item | (not available) | |
| Mac Address | detailed_hw_network_adapters.permanent_address | |
| Discovery source | (value hard coded to SG-BigFix) | |
| Display name | component_name, component_release, component_publisher_name | ✓ |
| Publisher | component_name, component_release, component_publisher_name | ✓ |
| Version | component_name, component_release, component_publisher_name | ✓ |
| Installed on | installed_on |