consolidate API request / response spec helpers