fixing api parlance and endpoints