JSON Schema for OpenAPI course

Looking to master JSON Schema for OpenAPI?

A 9+ hour course taught by a member of the JSON Schema Technical Steering Committee

Take the Video Course Also check out our O'Reilly book

minimum : Number

minimum

Number

Validation succeeds if the numeric instance is greater than or greater than or equal to the given number, depending on the value of exclusiveMinimum, if any

Value This keyword must be set to a number Hint: Use the jsonschema metaschema and jsonschema lint commands to catch keywords set to invalid values
Kind Assertion
Applies To Number
Base Dialect Draft 4
Changed In None
Introduced In Draft 1
Vocabulary Validation
Specification https://json-schema.org/draft-04/draft-fge-json-schema-validation-00#rfc.section.5.1.3
Metaschema http://json-schema.org/draft-04/schema#
Official Tests draft4/minimum.json
Default None
Annotation None
Affected By
Affects None
Also See

The minimum keyword restricts number instances to be greater than or equal to the given number.

Remember that JSON Schema is a constraint-driven language. Therefore, non-number instances successfully validate against this keyword. If needed, make use of the type keyword to constraint the accepted type accordingly.

Examples

A schema that constrains number instances to be greater than or equal to the positive integer 10 Schema 
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "minimum": 10
}
Valid A number value greater than 10 is valid Instance 
10.1
Valid An integer value greater than 10 is valid Instance 
11
Invalid A number value less than 10 is invalid Instance 
9.9
Invalid An integer value less than 10 is invalid Instance 
9
Valid The real representation of the integer value 10 is valid Instance 
10.0
Valid The integer value 10 is valid Instance 
10
Valid A non-number value is valid Instance 
"100000"
A schema that constrains number instances to be greater than or equal to the negative real number -2.1 Schema 
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "minimum": -2.1
}
Valid A number value greater than -2.1 is valid Instance 
-2.09
Valid An integer value greater than -2.1 is valid Instance 
-2
Invalid A number value less than -2.1 is invalid Instance 
-2.11
Invalid An integer value less than -2.1 is invalid Instance 
-3
Valid The real number value -2.1 is valid Instance 
-2.1
Valid A non-number value is valid Instance 
"100000"