reviewed api-def and 3rd party integration