required arguments
-none-
optional arguments:
full: one of true or false, defaults to false
format: one of plain or json, defaults to plain