fleshing out api bits