• General information
  • Installation
  • Configuration
  • Usage/admin
  • Troubleshooting
  • PQL - Puppet Query Language
  • API
  • Query API version 4
  • Extensions API version 1 (PE-only)
  • Admin API version 1
  • Command API version 1
  • Status API version 1
  • Metadata API version 1
  • Metrics API version 1
  • Wire formats

Version endpoint

This version is out of date. For current versions, see Puppet packages and versions.

The /version endpoint can be used to retrieve version information from the PuppetDB server.


This query endpoint will return version information about the running PuppetDB server.

This endpoint does not use any URL parameters or query strings.


This query will display a message describing the latest version of PuppetDB.

Response format

The response will be in application/json, and will return a JSON map with a single key: version, whose value is a string representation of the version of the running PuppetDB server.

{"version": "X.Y.Z"}


Using curl from localhost:

curl -X GET http://localhost:8080/pdb/meta/v1/version

{"version": "X.Y.Z"}

curl -X GET http://localhost:8080/pdb/meta/v1/version/latest

  "newer" : false,
  "product" : "puppetdb",
  "link" : "https://docs.puppetlabs.com/puppetdb/2.3/release_notes.html",
  "message" : "Version 2.3.4 is now available!",
  "version" : "2.3.4"
Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.