It's just great that the documentation tells me that for example 'states' is an array of strings and that it is optional.

What the actual values would be and under what circumstance remains a mistery.