add docs for get_states and changed empty list declaration