fleshing out json endpoint and examples