added API usage examples