Consumer represents the information of an event visitor or an order consumer.

Accepted methods

  • GET: Retrieve the details of a single consumer.

Accepted query parameters



All fields of Consumer object. Inserted 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).
phone_number String The telephone number of the consumer.
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.
language String Language code of the consumer (ISO 639-1). Optional.

Embedded resources


Example representation

    "_links": {
        "curies": [
                "href": "{rel}.html",
                "name": "shop",
                "templated": true,
                "type": "text/html"
        "profile": {
            "href": "",
            "type": "text/html"
        "self": {
            "href": ""
    "uid": "cba40d60019448278542c9f5ac1bf7ce",
    "address": "Some street 31",
    "city": "Some city",
    "country": "US",
    "date_of_birth": "1990-01-01",
    "email": "",
    "first_name": "John",
    "last_name": "Smith",
    "gender": 1,
    "phone_number": "+31 6 11 123456",
    "postal_code": "1234",
    "state": "UT",
    "language": "en"