Skip to main content
This is the most detailed endpoint. Given a board ID and a specific point release, it returns:
  1. The latest release currently available for that board/major version pair
  2. The release date of the version you requested
  3. The version proximo — the next update available after the version you specified
This is the endpoint used internally by the Proximos app to determine what update a Mac on a specific version should be moved to next.

​
Endpoint

GET https://proximosapi.enlazosystems.com/items/{boardID}:{version}
Authorization: YOUR_DECODED_LICENSE_KEY

​
Path Parameters

​
boardID
string
required
The Apple internal board identifier for the Mac model.
EraExample board IDs
Apple SiliconJ293AP, J413AP, J316cAP
IntelMac-35C5E08120C7EEAF, Mac-4B682C642B45593E
PowerPC (macOS 10.0–10.5)PowerPC
Classic Mac OSG3, G4, 68040, 68030, 68000
​
version
string
required
A full macOS point release version string — must include at least three components.
EraFormatExamples
Modern macOSX.Y.Z14.7.2, 15.3.1, 26.5.1
macOS 10.x10.Y.Z10.15.7, 10.14.6
Classic Mac OSX.Y.Z8.5.1, 9.2.2
Passing a major-only version (e.g. 14) or a two-part version (e.g. J293AP:14) to this endpoint will return a shorter response without the proximo fields. Use GET /items/: for that case.

​
Example Requests

curl -H "Authorization: YOUR_DECODED_LICENSE_KEY" \
  https://proximosapi.enlazosystems.com/items/J293AP:14.7.2

​
Response

[
  {
    "major_version": "14",
    "board_id_major_version": "J293AP:14",
    "releasedDate": "2026-05-11",
    "version": "14.8.7",
    "resolved_board_id": "J293AP",
    "requested_version": "14.7.2",
    "requested_releasedDate": "2024-12-11",
    "requested_version_proximo": "14.7.3",
    "requested_version_proximo_releasedDate": "2025-01-27"
  }
]

​
Response Fields

​
major_version
string
The major version of macOS for this record.
​
board_id_major_version
string
The internal DynamoDB composite key: {boardID}:{major_version}.
​
releasedDate
string
Release date of the latest available point release for this board/major, in YYYY-MM-DD format.
​
version
string
The latest available point release version for this board/major.
​
resolved_board_id
string
The board ID from the request path.
​
requested_version
string
The specific version you passed in the request path.
​
requested_releasedDate
string
The release date of the version you requested, in YYYY-MM-DD format.
​
requested_version_proximo
string
The next available update after the version you requested — the “version proximo.”If the version you requested is already the latest for this major, this will equal version (the latest).
​
requested_version_proximo_releasedDate
string
The release date of the version proximo, in YYYY-MM-DD format.

​
Understanding the Version Proximo

The version proximo is the immediate next release after the version you queried — not necessarily the latest. For example, if you query J293AP:14.7.2:
FieldValueMeaning
requested_version14.7.2The version you asked about
requested_version_proximo14.7.3The very next release after 14.7.2
version14.8.7The latest release on the 14.x branch
This makes it easy to walk a Mac through updates incrementally, one release at a time.