make example api more precise and consistent with tickets