The Proximos API

Full coverage of macOS Big Sur through today's releases, using Apple Silicon and Intel board IDs returned directly from hardware.

Every PowerPC and Intel release from Cheetah to Catalina, indexed by Intel board ID strings and Apple model numbers — so any Mac from any era can be looked up consistently.

68k and PowerPC classic Macs identified by their Apple model numbers (e.g. M0001 for the Mac 128K), verified against EveryMac.com, spanning the full history of the original Macintosh line.

The API checks Apple's software update infrastructure continuously every five minutes, keeping the macOS version database in near-real-time sync with Apple's own release pipeline.

New macOS versions are detected and written to the database without any manual intervention. Your scripts and workflows stay accurate the moment Apple publishes, without any action on your end.

Every GDMF poll and database update runs on scheduled AWS Lambda — the same reliable infrastructure that powers the Proximos app — so the update process itself never goes offline.

Get the latest point release and release date for any macOS major version — from 0.97 to 26 — with no board ID required. Great for simple version checks and release monitoring scripts.

Retrieve every macOS major version ever supported by a given Mac model. Pass a board ID like J293AP or M7777 and get back the full compatibility range for that hardware, spanning all eras.

The most detailed endpoint. Pass a board ID and a specific point release to get the latest available update for that model, the release date of the version you asked about, and the version proximo — the immediate next update available from that exact version.

Instead of only returning the latest available version, the API tells you the very next update from any specific point release — so you can build enforcement logic that steps through updates, not just jumps to the end.

Every proximo response includes the release date of both the version you queried and the next available update, giving you the full chronological picture for any enforcement or reporting workflow.

The version proximo endpoint is the same one used internally by the Proximos app to determine what update a Mac should be moved to next. It's not a feature added for the API — it's the heart of how Proximos works.

IP addresses, device identifiers, Mac board IDs sent in requests, and user-agent strings are never stored. Queries are logged by parameter for operational monitoring, not by who made them.

The only data tied to your identity is your license key, stored solely in AWS DynamoDB to authorize API requests. It is not used for analytics and is not shared with any third party.

Request counts are retained for one year for fair-use enforcement. Customer records — including your license key and purchase history — are kept for seven years in line with standard financial recordkeeping, then purged.

Every new license begins with a full 30 days of unrestricted access. No commitment required — just purchase and your trial starts immediately. 30 Days gives ample time to incorporate the API into your complex workflows.

The standard plan at $9.99/month covers up to 100,000 API requests under fair-use terms — more than enough for scripts, scheduled workflows, and production integrations. Payments processed securely via Stripe.

Qualifying educational institutions get the same full access at $6.99/month — because the tools that power good Mac management should be accessible to schools and universities too.

Dive deep into how Proximos API works under the hood — from its enforcement logic and scheduling engine to edge case behavior and advanced configuration options.

Example responses and detailed instructions on endpoint parameters.

Understand the philosophy behind Proximos API — its goals, design principles, and the real-world IT challenges it was built to solve.

Core Proximos processes run on AWS Lambda — a serverless, event-driven compute model recognized as one of the most reliable execution environments in the industry.

Backend licensing checks and macOS update queries are handled by AWS-managed databases and APIs, ensuring fast, consistent, and accurate responses at any scale.

All data exchanged between Proximos and its cloud backend is encrypted in transit, keeping your fleet's licensing information and update check data secure at every step.