Skip to content

Get all distinct foundation versions
Stable

Request

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
Query
limitinteger

Number of results to return per page

Default:10
offsetinteger

The initial index from which to return the results

Default:0
searchstring

Filter foundation versions by partial string match (case-insensitive)

cURL
curl -i -X GET \
  'https://develop-api.esper.io/_mock/openapi/v2/foundationversions?limit=10&offset=0&search=string'

Responses

Success

Bodyapplication/json
countinteger

Total number of distinct foundation versions

prevstring

URL to the previous page of results

nextstring

URL to the next page of results

resultsArray of objects
Response
{
  "count": 0,
  "prev": "string",
  "next": "string",
  "results": [
    { … }
  ]
}