API

All endpoints return JSON and are served from macosdb.com/api/v1/. Data is rebuilt on each release and served as static files — no authentication or rate limits.

Data is licensed under CC-BY-4.0.

Products

Replace {product} with macos or xcode in any endpoint below.

Releases

GET/api/v1/{product}/releases.json

Index of all releases with metadata, sorted newest first.

Example response

[
  {
    "buildNumber": "25E246",
    "osVersion": "26.4",
    "releaseName": "Tahoe",
    "releaseDate": "2026-03-24",
    "isBeta": false,
    "isRC": false,
    "dataFile": "releases/26/macOS-26.4-25E246.json"
  }
]

GET/api/v1/{product}/releases/{major}/{file}.json

Full release detail including components, kernels (macOS), and SDKs (Xcode).

Example: /api/v1/macos/releases/26/macOS-26.4-25E246.json

{
  "buildNumber": "25E246",
  "osVersion": "26.4",
  "releaseName": "Tahoe",
  "releaseDate": "2026-03-24",
  "isBeta": false,
  "isRC": false,
  "components": [
    {
      "name": "curl",
      "version": "8.7.1",
      "path": "/usr/bin/curl",
      "source": "filesystem"
    }
  ],
  "kernels": [
    {
      "darwinVersion": "25.4.0",
      "chip": "M4",
      "devices": [
        "Mac16,1"
      ]
    }
  ]
}

GET/api/v1/{product}/releases/latest.json

The most recent stable (non-beta, non-RC) release.

Example response

{
  "buildNumber": "25E246",
  "osVersion": "26.4",
  "releaseName": "Tahoe",
  "releaseDate": "2026-03-24",
  "isBeta": false,
  "isRC": false,
  "dataFile": "releases/26/macOS-26.4-25E246.json"
}

Components

GET/api/v1/{product}/components.json

All tracked components with their latest version.

Example response

[
  {
    "name": "curl",
    "version": "8.7.1",
    "source": "filesystem",
    "path": "/usr/bin/curl"
  },
  {
    "name": "LibreSSL",
    "version": "3.3.6",
    "source": "filesystem",
    "path": "/usr/bin/openssl"
  }
]

GET/api/v1/{product}/components/{name}.json

Version history for a single component across all releases.

Example: /api/v1/macos/components/curl.json

{
  "name": "curl",
  "source": "filesystem",
  "path": "/usr/bin/curl",
  "changes": [
    {
      "version": "8.7.1",
      "firstRelease": "macOS 15.0 Sequoia",
      "firstReleaseDate": "2024-09-16",
      "direction": "upgraded"
    },
    {
      "version": "8.6.0",
      "firstRelease": "macOS 14.4 Sonoma",
      "firstReleaseDate": "2024-03-07",
      "direction": "upgraded"
    }
  ]
}

Compare

GET/api/v1/{product}/compare/{from}/{to}.json

Diff components between two releases. Use {version}-{build} identifiers (e.g. 15.1-24B83).

Example: /api/v1/macos/compare/15.1-24B83/15.2-24C101.json

{
  "from": "macOS 15.1 Sequoia",
  "to": "macOS 15.2 Sequoia",
  "summary": {
    "upgraded": 3,
    "downgraded": 0,
    "added": 0,
    "removed": 0,
    "unchanged": 13
  },
  "changes": [
    {
      "name": "curl",
      "from": "8.7.1",
      "to": "8.11.1",
      "direction": "upgraded"
    }
  ],
  "added": [],
  "removed": []
}