read-only apis added for user-facing models