fleshing out API that will be provided