Collector Reference: IT Asset Management

The Snipe-IT collector discovers IT asset inventory from Snipe-IT, an open-source IT Asset Management (ITAM) platform. It provides the financial source of truth for hardware purchase costs, depreciation schedules, software licenses, and maintenance contracts.

---

Snipe-IT CollectorCopy Anchor Link

The Snipe-IT collector connects to the Snipe-IT REST API and discovers hardware assets, software licenses, and maintenance contracts. It handles Snipe-IT's nested API structures (flattening model, manufacturer, category, and status objects), resolves depreciation schedules from separate API lookups, and normalizes financial fields.

CI Types Discovered (3)Copy Anchor Link

AuthenticationCopy Anchor Link

• Snipe-IT API Token: Personal API token generated in Snipe-IT (Settings > API). Requires read access to hardware, licenses, and maintenances endpoints.
• Token is passed as Authorization: Bearer <token> header.

What Gets CollectedCopy Anchor Link

Hardware Assets:

• Config (tracked): Asset tag, serial number, model, manufacturer, category, status, purchase cost, purchase date, order number, warranty months/expiration, depreciation schedule, supplier, location, assigned user, custom fields
• Metrics (not tracked): Checkout counter, checkin counter, last audit date

Licenses:

• Config (tracked): License name, product key, seat count, category, manufacturer, purchase cost, purchase date, expiration date
• Metrics (not tracked): Free seats count, checkout count

Maintenance Contracts:

• Config (tracked): Title, cost, start/completion dates, warranty flag, maintenance type, supplier, associated asset name

Key RelationshipsCopy Anchor Link

• Maintenance contracts depends_on Hardware assets (matched by asset name)

How Snipe-IT Feeds CostCopy Anchor Link

Snipe-IT hardware purchase costs are a capital cost source for cost calculation. License and maintenance-contract costs are collected and tracked in change history, but they do not enter the cost model.

• Amortisation window. An asset charges its purchase cost divided by its depreciation months, starting at its purchase date and lasting that many calendar months. The months come from the asset's Snipe-IT depreciation schedule; an asset without one uses the default depreciation period, 36 months unless your deployment sets another. After the window the asset charges 0.
• Missing purchase date. An asset with a purchase cost but no usable purchase date is amortised with no end date and flagged on the Cost Explorer's Quality tab. Add the purchase date in Snipe-IT to bound it.
• Where the cost lands. The asset's cost is placed on one correlated record of the same machine, preferring the record that passes cost on to workloads (for example a Proxmox node), so it reaches the VMs running there. A capital rate card on the same machine is then superseded, including after the asset is fully depreciated.
• Currency. Snipe-IT shows an asset's purchase cost in the currency of the asset's location, or in its default currency when the asset has no location or the location has none. Parascope reads the currency the same way. Snipe-IT's API does not expose the default currency, so enter it as Default Currency on the source. A cost in another currency than your base currency is converted at the daily exchange rate, like any other cost. If no usable rate exists, or the currency is not a three-letter code (for example $), the asset is listed as unpriced on the Quality tab and left out of the totals. An asset with no currency at all, because its location has none and the source has no default currency, is treated as already being in your base currency.

ConfigurationCopy Anchor Link

Configured via Settings → Collectors when adding a Snipe-IT source.

---

Related DocumentationCopy Anchor Link

• Managing Collectors: Collector health and lifecycle
• How cost is calculated: How Snipe-IT purchase costs are amortised and placed
• CI Types: Complete CI type reference