Returns the distinct Foundation versions present across the tenant's devices.

Returns a de-duplicated list of Foundation (Esper's on-device agent/runtime) version strings currently reported by devices in the tenant, with search and pagination support.

About Foundation Versions Foundation is Esper's on-device software layer that enables management capabilities. Knowing which Foundation versions are present across a fleet is useful for understanding which devices may need an agent update before certain features or fixes are available to them.

Key Fields / Query Parameters

• search — Filter Foundation version strings by a search term
• limit / offset — Pagination controls

Common Use Cases

• Auditing Foundation version spread across the fleet before rolling out a feature that requires a minimum version
• Identifying outdated Foundation versions that may need an update
• Reporting on agent version compliance for a security or operations review

Best Practices

• Cross-reference results with the Device Tiles report if you need to find which specific devices are on an outdated version
• Check this before rolling out features gated on a minimum Foundation version
• Re-run periodically after a fleet-wide agent update to confirm rollout completion

Workflow

1. GET this endpoint to see the distinct Foundation versions present
2. Use the Device Tiles report or device list filters to find devices on outdated versions
3. Plan and execute a Foundation update for those devices as needed