Skip to content
Utilerio
All endpoints

Semver Comparator

POST/api/v1/tools/semver-comparator

Compare two semantic versions or check whether a version satisfies a range.

Authentication

Requires an API key in the X-API-Key header.

Try it

POST/api/v1/tools/semver-comparator

Parameters

modestringoptional

compare (default) or range.

comparerange
versionAstringoptional

First version (compare mode).

versionBstringoptional

Second version (compare mode).

versionstringoptional

Version to test (range mode).

rangestringoptional

npm-style semver range (range mode), e.g. ">=1.2.0 <2.0.0".

Request body

{
  "mode": "compare",
  "versionA": "1.2.3",
  "versionB": "1.3.0"
}

Response codes

  • 200Success.
  • 400Invalid request — check your body or parameters.
  • 401Missing or invalid API key.
  • 403The API key is not scoped to this endpoint.
  • 429Rate limit exceeded — retry after a short wait.

Language

cURL

Request

curl -X POST https://utilerio.com/api/v1/tools/semver-comparator \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"compare","versionA":"1.2.3","versionB":"1.3.0"}'

Response

{ "comparison": -1, "a": { "major": 1, "minor": 2, "patch": 3, "prerelease": [] }, "b": { "major": 1, "minor": 3, "patch": 0, "prerelease": [] } }