You can query catalogs by making an HTTP request to the /catalogs endpoint.

GET /v3/catalogs/<NODE>

This will return the most recent catalog for the given node.

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

Response Format

Successful responses will be in application/json. Errors will be returned as non-JSON strings.

The result will be a JSON map, with a metadata key and a data key. The value of the data key is another map, containing the keys name, version, transaction-uuid, edges, and resources. For more details on any of this data, please refer to the catalog wire format.


curl -X GET http://puppetdb:8080/v3/catalogs/foo.localdomain

  "data" : {
    "name" : "",
    "version" : "e4c339f",
    "transaction-uuid" : "53b72442-3b73-11e3-94a8-1b34ef7fdc95",
    "edges" : [...],
    "resources" : [...],
  "metadata" : {
    "api_version" : 1

Note: the edges and resources fields above will be populated with data conforming to the catalog wire format.

No Paging

This endpoint always returns a single result, so paging is not necessary.

Back to top
The page rank or the 1 our of 5 rating a user has given the page.
The email address of the user submitting feedback.
The URL of the page being ranked/rated.