add lists methods, more swagger documentation