documentation: json + additionnal query string

fixing the json after rewritting the api
adding another parameter to the query string