GET /items/{boardID}

Returns a comma-separated list of every macOS major version that the specified board ID (Mac model) has ever supported. Useful for quickly checking what macOS versions a given Mac is compatible with.

Endpoint

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

Path Parameter

string

required

The Apple board identifier for the Mac model. Must start with a letter and contain no periods or colons.

Era	Example board IDs
Apple Silicon	`J293AP`, `J413AP`, `J316cAP`, `J493AP`
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`
Virtual machines	`VMA2MACOSAP`, `VMM-x86_64`

For Motorola 68k and PowerPC Macs, the board ID is the Apple model number physically printed on the machine (e.g. M5521 for all iMac G3 350–700 MHz slot-loading models). These are verified against EveryMac.com. Where Apple assigned one model number to multiple machines, the database entry covers the union of their supported OS versions.

Example Requests

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

curl -H "Authorization: YOUR_DECODED_LICENSE_KEY" \
  https://proximosapi.enlazosystems.com/items/Mac-F4208EAA

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

Responses

Modern macOS

J293AP is the M1 MacBook Pro (14-inch, 2021). Apple Silicon Macs start at macOS 11 Big Sur.

{
  "board_id": "J293AP",
  "supported_macOS": "11.0, 12.0, 13.0, 14.0, 15.0, 26.0"
}

Legacy Mac OS X

Mac-F4208EAA is an early Intel iMac that shipped with Mac OS X 10.5 Leopard and received updates through OS X 10.11 El Capitan.

{
  "board_id": "Mac-F4208EAA",
  "supported_macOS": "10.5, 10.6, 10.7, 10.8, 10.9, 10.10, 10.11"
}

Classic Mac OS

M7777 is the Apple model number shared by all PowerBook Duo models (210, 230, 250, 270c, 280, and 280c). The union OS range spans System 7.0 through System 7.6.1, as the 68LC040-based Duo 280 and 280c raised the maximum from 7.5.5.

{
  "board_id": "M7777",
  "supported_macOS": "7.0, 7.1, 7.5, 7.6"
}

Response Fields

string

The board ID from the request path.

string

A comma-separated, version-sorted list of every macOS major version supported by this board ID. Results are sourced from both the primary and legacy DynamoDB tables, so a single model number that spans both Classic Mac OS and Mac OS X eras (such as M5521 for iMac G3) will return versions from both.Version formatting by era:

Modern macOS: X.0 suffix (e.g. 14.0, 26.0)
Legacy Mac OS X: 10.Y format (e.g. 10.9, 10.15)
Classic Mac OS: as-is (e.g. 8.5, 9.2, 7.1)

Notes

The API returns a 404 if no records are found for the given board ID.
Major versions are sorted in ascending order.
Results are sourced from both the primary and legacy DynamoDB tables.
To look up the latest release for a specific major version on this board, use GET /items/:. To look up the latest release for a specific major version on this board, use GET /items/:.

Finding Your Mac’s Board ID

You can find a modern Intel or Apple Silicon Mac’s board ID from the command line:

ioreg -d2 -c IOPlatformExpertDevice | grep board-id

Or use it in an MDM script:

board_id=$(ioreg -d2 -c IOPlatformExpertDevice | awk -F'"' '/board-id/{print $4}')
curl -H "Authorization: YOUR_DECODED_LICENSE_KEY" \
  "https://proximosapi.enlazosystems.com/items/${board_id}"

For PowerPC and 68k Macs, the board ID is the Apple model number printed on the underside or back of the machine (e.g. M5521, A1047).

Overview

API Reference

Endpoint

Path Parameter

Example Requests

Responses

Modern macOS

Legacy Mac OS X

Classic Mac OS

Response Fields

Notes

Finding Your Mac’s Board ID

​Endpoint

​Path Parameter

​Example Requests

​Responses

​Modern macOS

​Legacy Mac OS X

​Classic Mac OS

​Response Fields

​Notes

​Finding Your Mac’s Board ID

Endpoint

Path Parameter

Example Requests

Responses

Modern macOS

Legacy Mac OS X

Classic Mac OS

Response Fields

Notes

Finding Your Mac’s Board ID