DOCS
LLMs

Get Latest Release

Get Latest Release

Gets the most recent release for a product.

GET /api/v1/products/{slug}/releases/latest

Note: This endpoint does not require authentication.

Try it in the Interactive API Docs →

When to Use

  • Quick update check without fetching all releases
  • Display "New version available" notifications
  • Pre-download latest version info

Path Parameters

Parameter Required Description
slug Yes Product slug (e.g., my-app)

Query Parameters

Parameter Required Description
channel No Release channel: stable, beta, alpha
platform No Target platform: macos, windows, linux

Example Request 

curl "https://licenseseat.com/api/v1/products/my-app/releases/latest?platform=macos&channel=stable"

No authentication required.

Response 

{
  "object": "release",
  "version": "2.1.0",
  "channel": "stable",
  "platform": "macos",
  "published_at": "2024-01-15T12:00:00Z",
  "release_notes": "Bug fixes and performance improvements"
}

Response Fields

Field Description
version Semantic version string
channel Release channel (stable, beta, alpha)
platform Target platform
published_at Publication timestamp
release_notes Human-readable release notes

Error Codes

Code HTTP Meaning
not_found 404 No matching release exists

Update Check Pattern 

async function checkForUpdate(currentVersion) {
  const response = await fetch(
    `/api/v1/products/my-app/releases/latest?platform=macos&channel=stable`
  );

  if (response.status === 404) {
    return null; // No releases available
  }

  const latest = await response.json();

  if (isNewerVersion(latest.version, currentVersion)) {
    return latest;
  }

  return null;
}

See Also

Previous List Releases Next Generate Download Token