Comment 1 for bug 254696

That's because preferred_email_address and confirmed_email_addresses are the internal API we use to display a person's preferred email and the confirmed ones in separate sections of the web UI. That's indeed confusing, but I'm not yet sure it's worth having a separate API which included the preferred email and all confirmed ones, so I'm leaning towards fixing the docs for now.

Soren, would you be okay if we did just that for now or do you have any use-cases for a field containing all of a person's confirmed emails?