notes about api