expanding readme to include examples of api