Resolve a Package Version

GET 
/resolve

Resolve a Package Version. This endpoint resolves a package name + version string to the latest version of the package available in the Nixpkg repository. The response includes the Flake installable information for the package on each supported platform.

Request

Query Parameters

name stringrequired

The name of the package you want to resolve. Must be a valid Nixpkgs package name.

version stringrequired

The version string of the package you want to resolve.

Responses

200

OK

application/json

Schema

Schema

namestring

The name of the package that was resolved.

versionstring

The latest version the package that matches the version string provided in the request.

summarystring

A short description of the package

systems

object

A list of systems that the package can be installed on, along with the details of the Package on that system.

aarch64-darwin

object

flake_installable

object

The information needed to install this package as a flake reference.

ref

object

The full Nix reference to the flake that contains this package.

typestring

The type of flake reference. Usually this will be github.

ownerstring

The owner of the repository that contains the flake. Usually NixOS.

repostring

the repository that contains the flake. Usually nixpkgs

revstring

The Git revision of the flake. This is usually a commit hash.

attr_pathstring

The attribute path to the package in the flake. This can be used to install the package with Nix or Devbox.

last_updatedstring

The last time this package was updated in the Nixpkgs repo

outputs

object[]

A list of Outputs (e.g., out, lib, dev) that are available for the package on this platform.

Array [

namestring

The name of the output (e.g., out, lib, dev)

pathstring

The unique path to the output in the Nix store.

defaultboolean

Whether this output is the default output for the package

narstring

The path to the packages NAR (Nix Archive) file. This file contains the package's build artifacts.

]

aarch64-linux

object

flake_installable

object

The information needed to install this package as a flake reference.

ref

object

The full Nix reference to the flake that contains this package.

typestring

The type of flake reference. Usually this will be github.

ownerstring

The owner of the repository that contains the flake. Usually NixOS.

repostring

the repository that contains the flake. Usually nixpkgs

revstring

The Git revision of the flake. This is usually a commit hash.

attr_pathstring

The attribute path to the package in the flake. This can be used to install the package with Nix or Devbox.

last_updatedstring

The last time this package was updated in the Nixpkgs repo

outputs

object[]

A list of Outputs (e.g., out, lib, dev) that are available for the package on this platform.

Array [

namestring

The name of the output (e.g., out, lib, dev)

pathstring

The unique path to the output in the Nix store.

defaultboolean

Whether this output is the default output for the package

narstring

The path to the packages NAR (Nix Archive) file. This file contains the package's build artifacts.

]

x86_64-darwin

object

flake_installable

object

The information needed to install this package as a flake reference.

ref

object

The full Nix reference to the flake that contains this package.

typestring

The type of flake reference. Usually this will be github.

ownerstring

The owner of the repository that contains the flake. Usually NixOS.

repostring

the repository that contains the flake. Usually nixpkgs

revstring

The Git revision of the flake. This is usually a commit hash.

attr_pathstring

The attribute path to the package in the flake. This can be used to install the package with Nix or Devbox.

last_updatedstring

The last time this package was updated in the Nixpkgs repo

outputs

object[]

A list of Outputs (e.g., out, lib, dev) that are available for the package on this platform.

Array [

namestring

The name of the output (e.g., out, lib, dev)

pathstring

The unique path to the output in the Nix store.

defaultboolean

Whether this output is the default output for the package

narstring

The path to the packages NAR (Nix Archive) file. This file contains the package's build artifacts.

]

x86_64-linux

object

flake_installable

object

The information needed to install this package as a flake reference.

ref

object

The full Nix reference to the flake that contains this package.

typestring

The type of flake reference. Usually this will be github.

ownerstring

The owner of the repository that contains the flake. Usually NixOS.

repostring

the repository that contains the flake. Usually nixpkgs

revstring

The Git revision of the flake. This is usually a commit hash.

attr_pathstring

The attribute path to the package in the flake. This can be used to install the package with Nix or Devbox.

last_updatedstring

The last time this package was updated in the Nixpkgs repo

outputs

object[]

A list of Outputs (e.g., out, lib, dev) that are available for the package on this platform.

Array [

namestring

The name of the output (e.g., out, lib, dev)

pathstring

The unique path to the output in the Nix store.

defaultboolean

Whether this output is the default output for the package

narstring

The path to the packages NAR (Nix Archive) file. This file contains the package's build artifacts.

]

Example (from schema)

{
  "name": "string",
  "version": "string",
  "summary": "string",
  "systems": {
    "aarch64-darwin": {
      "flake_installable": {
        "ref": {
          "type": "string",
          "owner": "string",
          "repo": "string",
          "rev": "string"
        },
        "attr_path": "string"
      },
      "last_updated": "string",
      "outputs": [
        {
          "name": "string",
          "path": "string",
          "default": true,
          "nar": "string"
        }
      ]
    },
    "aarch64-linux": {
      "flake_installable": {
        "ref": {
          "type": "string",
          "owner": "string",
          "repo": "string",
          "rev": "string"
        },
        "attr_path": "string"
      },
      "last_updated": "string",
      "outputs": [
        {
          "name": "string",
          "path": "string",
          "default": true,
          "nar": "string"
        }
      ]
    },
    "x86_64-darwin": {
      "flake_installable": {
        "ref": {
          "type": "string",
          "owner": "string",
          "repo": "string",
          "rev": "string"
        },
        "attr_path": "string"
      },
      "last_updated": "string",
      "outputs": [
        {
          "name": "string",
          "path": "string",
          "default": true,
          "nar": "string"
        }
      ]
    },
    "x86_64-linux": {
      "flake_installable": {
        "ref": {
          "type": "string",
          "owner": "string",
          "repo": "string",
          "rev": "string"
        },
        "attr_path": "string"
      },
      "last_updated": "string",
      "outputs": [
        {
          "name": "string",
          "path": "string",
          "default": true,
          "nar": "string"
        }
      ]
    }
  }
}

400

400 Bad Request: empty name (set a ?name=<value> query parameter)

404

Not Found