making good progress understanding the api