notes on api