TRY ME

Try Valo for free

We want to show you something amazing.

We'll send you a link to download a fully functional Valo copy to play with.



Great! Check your email and enjoy Valo



Apologies, we seem to be having a problem processing your input, please try again

Data Formats

Valo REST API end-points speak JSON by default. Exceptions to this rule will be documented along with the end-point.

You can choose other formats via the Content-Type and Accept headers:

POST /streams/demo/infrastructure/cpu HTTP/1.1
Content-Type: application/yaml
GET /streams/demo/infrastructure/cpu HTTP/1.1
Accept: application/cbor

The supported formats are:

Format MIME type Supports Hierarchical Data
BSON application/bson Yes
CBOR application/cbor Yes
CSV application/csv Partial. Arrays are supported using ; as separator
JSON application/json Yes
Smile application/x-jackson-smile Yes
YAML application/yaml Yes
VBOR application/vbor Yes
MessagePack application/msgpack Yes

The only “non standard” format in the table above is VBOR which stands for “Valo Binary Object Representation”. It is a Valo specific data format derived from CBOR.

CSV MIME Options

There are several MIME options when CSV files are sent to Valo, for instance: Content-Type: application/csv; columnSeparator=\;; arraySeparator=,

The supported options are:

Option Description Default value
columnSeparator Character used for column separation , - Char
arraySeparator Character used within a column to indicate the value is an array ; - Char
quoteChar Character used for quotation of string literals " - Char
escapeChar Escape character 0xFFFF - Char (there is no escape character)
lineSeparator Sequence of characters that indicate a line end \n - Char
nullValue How null values are defined (empty string) - Char
useHeader Flag that indicates if the header should be used false - Boolean
skipFirstRow The parser should skip the first row false - Boolean