api clarification