abc the api functions