expected API