Type-specific keywords

The type keyword is fundamental to JSON Schema. It specifies the data type for a schema.

At its core, JSON Schema defines the following basic types:

• string
• number
• integer
• object
• array
• boolean
• null

These types have analogs in most programming languages, though they may go by different names.

The type keyword may either be a string or an array:

• If it's a string, it is the name of one of the basic types above.
• If it is an array, it must be an array of strings, where each string is the name of one of the basic types, and each element is unique. In this case, the JSON snippet is valid if it matches any of the given types.

Here is a simple example of using the type keyword:

schema

{ "type": "number" }

data

42

compliant to schema

data

42.0

compliant to schema

data

"42"

not compliant to schema

In the following example, we accept strings and numbers, but not structured data types:

schema

{ "type": ["number", "string"] }

data

42

compliant to schema

data

"Life, the universe, and everything"

compliant to schema

data

["Life", "the universe", "and everything"]

not compliant to schema

For each of these types, there are keywords that only apply to those types. For example, numeric types have a way of specifying a numeric range, that would not be applicable to other types. In this reference, these validation keywords are described along with each of their corresponding types in the following chapters.