more concrete examples of api