• 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

Facts wire format, version 4


Facts wire format - v4

Facts are represented as JSON. Unless otherwise noted, null is not allowed anywhere in the set of facts.

{"certname": <string>,
 "environment": <string>,
 "producer_timestamp": <datetime>,
 "values": {
     <string>: <any>,

The "certname" key is the certname the facts are associated with.

The "environment" key is the environment associated to the node when the facts were collected.

The "values" key points to a JSON Object that represents the set of facts. Each key is the fact name, and the value is the fact value.

The "producer_timestamp" key points to a timestamp reflecting the time of fact set submission from the Puppet Server to PuppetDB.

Fact names and values must be strings.


The entire fact set is expected to be valid JSON, which mandates UTF-8 encoding.

Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.