***************
Ticket consumer
***************
An object representing a ticket consumer in our system.

Has all fields from :doc:`../documentation/consumer`, included here for ease of reference:

============== ============= ==========================================================================================================================================================================================================================================================================================================================================
Field name     Type          Description
============== ============= ==========================================================================================================================================================================================================================================================================================================================================
uid            String        Optional, a machine readable id for this consumer, used in communication with the API. For ``POST`` methods, you can only use uid to refer to an existing consumer, and then the fields below will be all optional, as the consumer data exists in the records. If any other field provided, a new revision of the consumer will be created.
first_name     String        The first name of the consumer.
last_name      String        The last name of the consumer.
date_of_birth  Date          The date of birth of the consumer.
email          String        The email of the consumer, which can be used for any correspondence about their order or ticket.
gender         Number        The gender of the consumer (0=unknown, 1=male, 2=female, 9=other).
address        String        The street and house number of the consumer.
postal_code    String        The postal code (or zipcode) of the consumer.
city           String        The city of residence of the consumer.
country        String        The country of the consumer.
state          String        The state of the consumer. Optional; only required when the country is the USA or Brazil.
============== ============= ==========================================================================================================================================================================================================================================================================================================================================