GET /items/{boardID}:{version}

This is the most detailed endpoint. Given a board ID and a specific point release, it returns:

The latest release currently available for that board/major version pair
The release date of the version you requested
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

string

required

The Apple board identifier for the Mac model.

Era	Example board IDs
Apple Silicon	`J293AP`, `J413AP`, `J316cAP`
Intel	`Mac-35C5E08120C7EEAF`, `Mac-4B682C642B45593E`
PowerPC Mac OS X (10.0–10.5)	`M5183`, `A1047`, `M8493`, `M6498`, `A1103`
Classic Mac OS 68k	`M0001`, `M5119`, `M1476`, `M7777`, `M4300`
Classic Mac OS PPC	`M1688`, `M3979`, `M5521`, `M4984`, `M8570`

For Motorola 68k and PowerPC Macs, the board ID is the Apple model number physically printed on the machine. These are verified against EveryMac.com.

string

required

A full macOS point release version string — must include at least three components.

Era	Format	Examples
Modern macOS	`X.Y.Z`	`14.7.2`, `15.3.1`, `26.5.1`
Legacy Mac OS X	`10.Y.Z`	`10.9.3`, `10.4.9`
Classic Mac OS	`X.Y.Z`	`9.0.2`, `8.5.1`, `7.1.1`

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. 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

curl -H "Authorization: YOUR_DECODED_LICENSE_KEY" \
  https://proximosapi.enlazosystems.com/items/M5183:10.4.9

curl -H "Authorization: YOUR_DECODED_LICENSE_KEY" \
  https://proximosapi.enlazosystems.com/items/M5521:9.0.2

Responses

Modern macOS

[
  {
    "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"
  }
]

Legacy Mac OS X

M5183 covers the Power Mac G3 Blue & White and all G4 PCI/AGP/Gigabit/Digital Audio models. Mac OS X 10.4.9 is followed immediately by 10.4.10, with 10.4.11 as the final Tiger release.

[
  {
    "major_version": "10.4",
    "board_id_major_version": "M5183:10.4",
    "releasedDate": "2007-11-14",
    "version": "10.4.11",
    "resolved_board_id": "M5183",
    "requested_version": "10.4.9",
    "requested_releasedDate": "2007-03-13",
    "requested_version_proximo": "10.4.10",
    "requested_version_proximo_releasedDate": "2007-06-20"
  }
]

Classic Mac OS

M5521 covers all slot-loading iMac G3 models (350–700 MHz). Mac OS 9.0.2 is followed by 9.0.3, with 9.0.4 as the final Mac OS 9.0 release.

[
  {
    "major_version": 9.0,
    "board_id_major_version": "M5521:9.0",
    "releasedDate": "2000-04-04",
    "version": "9.0.4",
    "resolved_board_id": "M5521",
    "requested_version": "9.0.2",
    "requested_releasedDate": "2000-03-06",
    "requested_version_proximo": "9.0.3",
    "requested_version_proximo_releasedDate": "2000-04-01"
  }
]

Response Fields

string | number

The major version of macOS for this record. A string for modern macOS and Legacy Mac OS X; a number for Classic Mac OS.

string

The internal DynamoDB composite key: {boardID}:{major_version}.

string

Release date of the latest available point release for this board/major, in YYYY-MM-DD format.

string

The latest available point release version for this board/major.

string

The board ID from the request path.

string

The specific version you passed in the request path.

string

The release date of the version you requested, in YYYY-MM-DD format.

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).

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:

Field	Value	Meaning
`requested_version`	`14.7.2`	The version you asked about
`requested_version_proximo`	`14.7.3`	The very next release after 14.7.2
`version`	`14.8.7`	The latest release on the 14.x branch

The same logic applies across all eras. Querying M5521:9.0.2 returns a proximo of 9.0.3 — the very next Classic Mac OS release — while version shows 9.0.4 (the latest on the 9.0.x branch).

Overview

API Reference

GET /items/{boardID}:{version}

Endpoint

Path Parameters

Example Requests

Responses

Modern macOS

Legacy Mac OS X

Classic Mac OS

Response Fields

Understanding the Version Proximo

​Endpoint

​Path Parameters

​Example Requests

​Responses

​Modern macOS

​Legacy Mac OS X

​Classic Mac OS

​Response Fields

​Understanding the Version Proximo

Endpoint

Path Parameters

Example Requests

Responses

Modern macOS

Legacy Mac OS X

Classic Mac OS

Response Fields

Understanding the Version Proximo