wired up primary api interface