api and examples