The courriel class exists to provide a high level api for working with emails, particular for processing incoming email. it is primarily a wrapper around the other classes in the courriel distro, especially courriel::headers, courriel::part::single, and courriel::part::multipart. if you need lower level information about an email, it should be available from one of this classes.