Analytics Vidhya
Published in

Analytics Vidhya

Server validation in Flask API with JSON schema

Photo by Aviv Perets on pexels

Validation in the API world means checking if the data send is good or not. You never can entirely rely on having only a client-side validation. Because you don’t know what’s happening on the client, you can’t trust the data you receive. Even if you have a private API, someone could still send you invalid requests.

Server-side validation implied checking multiple things :

  • what are the expected properties
  • does they have the good format/type
  • is the property required

Json schema

The JSON Schema is a way to describe any instance of JSON data, like the ones found in our HTTP request or response.

The keyword type will restrict your property to a certain type. There is several possible values :

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


"my_param": { "type": "number" }

You can ensure that you parameter is inside a certain range with additional parameters :

  • xminimum
  • x > exclusiveMinimum
  • xmaximum
  • x < exclusiveMaximum
"my_param": { 
"type": "number",
"minimum": 0,
"maximum": 100


"my_param": { "type": "string" }

There is also some optional parameters :

  • minLength (minimum numbers of characters my string can contain)
  • maxLength (maximum numbers of characters my string can contain)
  • Pattern (it’s a regex, will be consider as valid if the string match the regex)
"firstname": {
"type": "string",
"minLength": 2,
"maxLength": 50


"my_param": { "type": "object" }

With properties you can describe all the variables inside of your object.

"type": "object",
"properties": {
"number": { "type": "number" },
"street_name": { "type": "string" },
"required": ["street_name"]

One important keyword in required. It will make sure that some of the values are send in the request.


"my_param": { "type": "array" }

You can apply validation to the elements of the array if they all follow the same schema. You can check length of the array minItems and maxItems.

"my_param": { 
"type": "array,
"minItems": 3,
"items: {
"type": "number"

You can create list of complex elements, and have list of objects that themselves contains lists…


"my_param": { "type": "boolean" }

No real surprise here, the value can either be True or False


"my_param": { "type": "null" }

Is used to represent a missing value, it’s equivalent to None in python

Multiple types

Maybe a parameter can have multiple possible type, for example string and None. When the value send can be either empty or a string.

"my_param": { "type": ["string, "null"] }

Validation with Flask

The package

There is several python packages that will do validation based on JSON schema. I personally use flask-expects-json.

To install it :

pip install flask-expects-json

How it work

The package simply works as a decorator for your flask endpoints.

schema = {
"type": "object",
"properties": {
"name": { "type": "string" },
"email": { "type": "string" }
"required": ["email"]
@app.route('/', methods=['POST'])
def example_endpoint():

If the request received does not correspond to the schema it will raise an error. And a 400 error will be send as a response.-

Skip validations methods

If your endpoint has several method, you can ignore the validation for some of them.

@app.route('/', methods=['GET', 'POST'])
@expects_json(schema, ignore_for=['GET'])
def example():

There is other useful keywords in the json-schema. I’ve only covered here the most useful ones.




Analytics Vidhya is a community of Analytics and Data Science professionals. We are building the next-gen data science ecosystem

Recommended from Medium

Your Code Smells

GZIP data compression has a critical role of increasing performance and smashing the monstrous…

Run Monika with multiple Monika configurations at the same time

Secret Manager: Improve Cloud Run security without changing the code

Install PostgreSQL 12 and PgAdmin4 on Ubuntu 18.04.4 LTS

11 Laws of Software Estimation for Complex Work

Female predicting timelines

How to create a tile grid overlay for the Garmin Edge based on VeloViewer unexplored tiles

Max Kelsen Sinks Their Teeth Into KubeCon: Day Three

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Alexis Gomes

Alexis Gomes

I work at yper. I’m a python developer, learning data science. I’ve made a app

More from Medium

Making a NYSE stock watchlist backend with Node js and Postgres database

Working with WTForms and Oracle REST Database Services (ORDS) APIs

How to create a FastAPI / Uvicorn server windows service

Executing Python MapReduce Jobs using Hadoop inside Docker Containers on Apple Silicon Mac