more notes on using this API example.