Skip to main content

Receiving Data

In response to requests, you'll always receive a JSON object containing any number of potential fields. Details for the fields that will be returned from any request are outlined in this documentation with each endpoint.

JSON​

All responses will be a JSON-encoded and will be accompanied with an apprpriate content type header of application/json. If you receive a request that does not have this header, it is likely a server issue and we will have been notified.

Types​

Each field has a specific type that lets you know what sort of data you can expect to receive. There are numerous types of data available.

  • Scalars - these are things like strings, integers, decimals, timestamps etc...
  • Objects - these are more complex structures where another object is returned with its own set of fields. In this documentation, you can always click on an object to see all the fields that are available within it.
  • Enum - these are usually strings in JSON but will always match a specific value from the associated list of options in the documentation.
  • Polymorph - these are similar to objects but occur when a field could return a variety of other objects. They let you know what type of object is being returned as well as the data within.

Arrays​

In some cases, the API will need to return an array. In these cases, the array will simply contain items of the type specified.