added API documentation for lists in header