fleshing out API usage