maximum : Number

maximum

Number

Validation succeeds if the numeric instance is less than or equal to the given number.

Kind Assertion
Applies To Number
Dialect 2020-12
Introduced In Draft 1
Vocabulary Validation
Specification https://json-schema.org/draft/2020-12/json-schema-validation.html#section-6.2.2
Metaschema https://json-schema.org/draft/2020-12/meta/validation
Also see

The maximum keyword is used to set the upper limit on numeric instances. It specifies that the numeric value being validated must be less than or equal to the provided maximum value.

  • Applies only to number data types (integers and floats).
  • Validation succeeds if the number is less than or equal to the specified maximum.

Examples

Schema defining the upper limit of 10 on numeric values Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "number",
  "maximum": 10
}
An instance with a numeric value less than 10 is valid Instance 
9.5
An instance with a numeric value greater than 10 is invalid Instance 
15
An instance with a numeric value equal to 10 is valid Instance 
10
Schema allowing either a boolean value or a numeric value with an upper limit of 20.99 Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": [ "boolean", "number" ],
  "maximum": 20.99
}
An instance with a numeric value less than 20.99 is valid Instance 
15
An instance with a string datatype is invalid Instance 
"Hello World!"
An instance with a boolean value is valid Instance 
true