basic API for 1.0 goal