started fleshing out basic requirements of main api methods