proper api call results returned to callers