Skip to main content
Proximos API Hero
The Proximos API is a simple, read-only HTTP GET API that gives you programmatic access to the complete history of macOS releases and compatible Mac models — from Classic Mac System 0.97 on the original Mac 128k all the way to the latest macOS releases today. Use it to build custom private workflows around macOS release dates, version history, and compatible hardware identifiers (board IDs).

​
What you can look up

  • The latest release for any macOS major version number
  • The latest update available for a specific Mac model (board ID) on a given major version
  • The next available update from a specific version — the version proximo
  • All compatible board IDs for a given macOS version
  • All supported macOS versions for a specific board ID

​
Base URL

All requests are HTTPS GET requests to:

​
Get Started Quickly

Skip writing requests from scratch — import a ready-made collection into your tool of choice.

OpenAPI Specification

OpenAPI 3.1 spec for the Proximos API (v1.5) — generate a client SDK or import into your API tooling.

Postman Collection

Every endpoint pre-configured with authentication — import it and add your license key to start making requests.

​
Coverage

Modern macOS

macOS 11 Big Sur – macOS 26Apple’s internal board IDs returned directly by the hardware. Apple Silicon: J293AP, J413AP. Intel: Mac-35C5E08120C7EEAF. VMs: VMA2MACOSAP.

Legacy Mac OS X

Mac OS X 10.0 Cheetah – OS X 10.15 CatalinaIntel Macs (10.6–10.15) use board ID strings (e.g. Mac-F4208EAA). PowerPC Macs (10.0–10.5) use Apple model numbers (e.g. M5183, A1047).

Classic Systems

System 0.97 – Mac OS 9.2.2Classic Board IDs are Apple model numbers from the machine label. e.g. M0001 (Mac 128K), M7777 (PowerBook Duo), M5521 (iMac G3).

Purchase a License

30-day free trial · 9.99/monthstandard⋅9.99/month standard · 6.99/month educational