Migrating from v1

What changed

v2 is a ground-up redesign of the API. The base URL, envelope format, field names, and URL structure are all different.

Base URL

Endpoint paths

Response envelope

v1:

{
  "DataForNerds": {
    "LastUpdatedUTC": "2026-05-25T06:15:30.0000000Z",
    "SourceList": ["https://support.microsoft.com/..."]
  },
  "Data": [...]
}

v2:

{
  "metadata": {
    "provider": "DataForNerds",
    "apiVersion": "v2",
    "dataset": "windows-update-history",
    "recordCount": 1842,
    "sourceUrls": ["https://support.microsoft.com/..."],
    "lastModified": "2026-05-25T06:15:30.0000000Z",
    "lastCollected": "2026-05-25T06:15:30.0000000Z"
  },
  "data": [...]
}

Key differences:

• The wrapper key changed from DataForNerds to metadata and Data to data
• LastUpdatedUTC / SourceList replaced by richer metadata fields
• recordCount, dataset, provider, and apiVersion are new

Windows Update History fields

Windows Release History fields

M365 Apps Update History fields

Channel name changes:

Language Codes fields

Other changes

• JSON Schemas - every v2 dataset has a published schema at /v2/microsoft/schemas/<dataset>.schema.json, linked via the Link response header
• Dataset catalog - GET /v2/index.json returns a machine-readable list of all datasets with URLs, descriptions, and lastModified timestamps
• Changelogs - each dataset has a changelog at /v2/microsoft/<dataset>.changelog.json
• CORS - v2 returns full CORS headers (Access-Control-Allow-Origin: *); v1 did not
• Caching - v2 uses Cache-Control: public, max-age=21600, stale-while-revalidate=86400 (6-hour cache); v1 used the same policy
• Deprecation header - all v1 responses now include Deprecation: true and a Link header pointing to v2

Migration example

v1 (PowerShell):

$response = Invoke-RestMethod 'https://raw.datafornerds.io/ms/mswin/buildnumbers.json'
$updates = $response.Data
$updates | Where-Object { $_.Win10Version -like '10.0.22621.*' }

v2 (PowerShell):

$response = Invoke-RestMethod 'https://api.datafornerds.io/v2/microsoft/windows-update-history.json'
$updates = $response.data
$updates | Where-Object { $_.FullVersion -like '10.0.22621.*' }

Timeline