# /systems/{id}/inventory/timeline - Get inventory timeline grouped by date

**GET /systems/{id}/inventory/timeline**

Get a date-grouped inventory timeline for a specific system.
Returns a filtered summary (severity counters) and groups of inventory dates.
Each group includes `inventory_ids` — the IDs of inventory records collected that day.
Groups with no matching diffs still appear with `change_count: 0`, allowing the UI
to display "X inventories, no changes" badges. Pagination is over date groups.
To fetch the actual diffs for a group, call `GET /systems/{id}/inventory/diffs?inventory_id=42&inventory_id=43`
with the `inventory_ids` from the group.
Supports text search on diff field paths and values.



## Servers
- Backend API server (port 8080): https://api.your-domain.com/api (Backend API server (port 8080))
- Collect API server (port 8081): https://collect.your-domain.com/api (Collect API server (port 8081))


## Authentication methods
- Bearer auth


## Parameters

### Path parameters
- **id** (string)
  System ID

### Query parameters
- **page** (integer)
  Page number
- **page_size** (integer)
  Items per page
- **search** (string)
  Case-insensitive text search across diff field_path, previous_value, and current_value. Affects change_count in groups and summary counters.
- **severity** (array[string])
  Filter by severity level. Supports multiple values.
- **category** (array[string])
  Filter by change category. Supports multiple values.
- **diff_type** (array[string])
  Filter by diff type. Supports multiple values.
- **from_date** (string(date-time))
  Show dates from this timestamp (RFC3339 format)
- **to_date** (string(date-time))
  Show dates up to this timestamp (RFC3339 format)


## Responses
### 200
Inventory timeline retrieved successfully

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object)


### 401
Unauthorized - invalid or missing token

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)


### 403
Forbidden - insufficient permissions

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)


### 404
Resource not found

#### Body: application/json (object)
- **code** (integer)
  HTTP error code
- **message** (string)
  Error message
- **data** (object)



[Powered by Bump.sh](https://bump.sh)