API clarifications