some API notes