Key Value Pairs

While our APIs aim to provide dedicated named attributes for most data points, some data requires more flexibility. For these cases, we use Key-Value Pairs (KVPs) - an array of additional data that allows for dynamic attribute storage.

These KVPs are “loosely typed” - all values are stored as strings, though you can specify a type to provide usage hints. Note that type specifications are generally not strictly enforced.

Understanding KVP Types

KVP types help describe the data content and its intended use. Here’s what you need to know about the different categories:

Complete Type Reference

  - defunct 
  - general.string 
  - general.integer 
  - general.float 
  - general.bool 
  - general.date 
  - general.datetime
Best Practice

When working with sensitive data that needs to be used only once, consider using transient.* types. These values are processed during the initial call but aren’t persisted in storage.

Built with