entities v1 API complete