finished api functions for all of the bottom level model types