Get Foundry builds
Returns a deduplicated list of all Esper Foundation OS version strings currently present across enrolled devices in the tenant.
Use this endpoint to inventory which Foundation OS versions are deployed across your fleet — useful for identifying version spread, spotting devices running outdated builds, and scoping update operations.
About Get All Distinct Foundation Versions
Esper Foundation is a customized Android-based operating system for x86 and ARM devices, providing long-term support, regular security patches, and broad hardware compatibility. Foundation version strings follow the format [Android version].[Major Foundation version].[Minor Foundation version].[Build version] — for example, 7.10.21.02 indicates Android 7, Major Foundation version 10, Minor version 21, build 02. This endpoint returns each distinct version once regardless of how many devices share it, giving a fleet-wide view of OS version distribution. It requires the read:foundationversions scope.
Key Fields / Query Parameters
search — Partial string match (case-insensitive) to filter returned version strings
limit — Number of results per page; defaults to 10
offset — Starting index for pagination
foundation_version — The version string returned per result, in [Android].[Major].[Minor].[Build] format
Common Use Cases
Auditing Foundation OS version spread across a fleet before planning an update campaign
Identifying whether devices running builds below a minimum supported version are present in the tenant
Cross-referencing deployed versions against the latest approved builds visible in Esper Software Updates for Foundation
Best Practices
Use search to quickly check whether a specific Foundation version is present rather than paginating the full list
Combine results with device list endpoints filtered by Foundation version to enumerate specific devices on a given OS version
Call this before scheduling OTA operations to establish a version distribution baseline
Workflow
Call GET /api/v2/foundationversions to retrieve all distinct Foundation OS versions present in the tenant
Compare results against the latest approved build in Esper Software Updates for Foundation to identify outdated versions
Use device list endpoints filtered by Foundation version to target devices on older builds for update via Pipeline, auto-update, or API-based FOTA
Query parameters
Filter by Esper Foundation Major Number, Foundation Numbers are integers starting at 1.
Filter by build architecture name, build architectures {arm, arm64, x86_64, x86}
Filter by Android Major Version, Android Major Versions are integers starting at 1 and going to Current Android Release
Device model id
Filter builds which have been approved for OTA update
Filter the locked builds. To be used with build_fingerprint_hash and device_model_id
hash of the build fingerprint of the existing build
Response
List of Foundry builds