better readme for represent api, add pending to greenparty.ca spec