more detail on input and output format for endpoints