prototype interface for API completed