> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enlazosystems.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /items/{boardID}:{version}

> Look up a specific version for a board ID, including the next available update.

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

```http theme={null}
GET https://proximosapi.enlazosystems.com/items/{boardID}:{version}
Authorization: YOUR_DECODED_LICENSE_KEY
```

## Path Parameters

<ParamField path="boardID" type="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`    |

  <Note>
    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.
  </Note>
</ParamField>

<ParamField path="version" type="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`    |

  <Note>
    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/](/proximos-api/endpoints/get-boardid-major){boardID}[:](/proximos-api/endpoints/get-boardid-major){majorVersion} 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/](/proximos-api/endpoints/get-boardid-major){boardID}[:](/proximos-api/endpoints/get-boardid-major){majorVersion} for that case.
  </Note>
</ParamField>

## Example Requests

<CodeGroup>
  ```bash Modern macOS theme={null}
  curl -H "Authorization: YOUR_DECODED_LICENSE_KEY" \
    https://proximosapi.enlazosystems.com/items/J293AP:14.7.2
  ```

  ```bash Legacy Mac OS X theme={null}
  curl -H "Authorization: YOUR_DECODED_LICENSE_KEY" \
    https://proximosapi.enlazosystems.com/items/M5183:10.4.9
  ```

  ```bash Classic Mac OS theme={null}
  curl -H "Authorization: YOUR_DECODED_LICENSE_KEY" \
    https://proximosapi.enlazosystems.com/items/M5521:9.0.2
  ```
</CodeGroup>

## Responses

### Modern macOS

```json theme={null}
[
  {
    "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.

```json theme={null}
[
  {
    "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.

```json theme={null}
[
  {
    "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

<ResponseField name="major_version" type="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.
</ResponseField>

<ResponseField name="board_id_major_version" type="string">
  The internal DynamoDB composite key: `{boardID}:{major_version}`.
</ResponseField>

<ResponseField name="releasedDate" type="string">
  Release date of the **latest** available point release for this board/major, in `YYYY-MM-DD` format.
</ResponseField>

<ResponseField name="version" type="string">
  The **latest** available point release version for this board/major.
</ResponseField>

<ResponseField name="resolved_board_id" type="string">
  The board ID from the request path.
</ResponseField>

<ResponseField name="requested_version" type="string">
  The specific version you passed in the request path.
</ResponseField>

<ResponseField name="requested_releasedDate" type="string">
  The release date of the version you requested, in `YYYY-MM-DD` format.
</ResponseField>

<ResponseField name="requested_version_proximo" type="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).
</ResponseField>

<ResponseField name="requested_version_proximo_releasedDate" type="string">
  The release date of the version proximo, in `YYYY-MM-DD` format.
</ResponseField>

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