The *extra\_info* method
========================

Returns the extra information associated with the
event.

.. hint:: 
  Information can be requested using the "mime\_text\_type" input as described in the section on :ref:`calling_conventions`


Input
------

Required inputs
~~~~~~~~~~~~~~~

- "crypto\_block" from "event\_search". 
- "event\_token" element. 


Optional Input
~~~~~~~~~~~~~~

- "source\_info"


Example input
~~~~~~~~~~~~~

.. code-block:: xml

        <extra_info>
            <user_id>demo</user_id>
            <crypto_block>M_--qRfq64CDfM9Vj4JBQdRMdOJPW0xEpX1WsPqJY6Sy_X--q
            -u7vOoeQH9kWHcDhhX0y1R6--Q5LYtL2zZeBLtUFtT8k2_EW3NjhoJBWdGhx6TV
            _mcqVl1vM---Y</crypto_block>
            <event_token>MQ2JX</event_token>
        </extra_info>

Output data
-----------

- **source\_after\_sales\_email** - The email address which should
   be used for after-sales customer services.

- **source\_card\_statement\_desc** - The text which will appear
   on the customers credit card statement as the debitor for this event.

- **source\_enquiries\_email** - The email address for general
   enquiries regarding this supplier.

- **source\_local\_phone** - Details of how to telephone customer
   services for customers located in the suppliers country.

- **source\_local\_fax** - Details of how to send a fax to
   customer services for customers located in the suppliers country.

- **source\_international\_phone** - Details of how to telephone
   customer services for customers located outside the suppliers
   country.

- **source\_international\_fax** - Details of how to send a fax to
   customer services for customers located outside the suppliers
   country.

- **source\_postal\_addr** - The postal address for sending
   physical mail to customer services.

- **source\_t\_and\_c** - The suppliers terms and conditions. This
   will usually be a long paragraph of legal text which should be made
   available to the customer in some way.


About Media Assets
------------------

To request the media assets which may be associated with an event a
number of "request\_media" elements may be included in the input, each
containing the same of a media file to be returned if possible. For each
available requested media asset, an "event\_media" element will be
present in the output Each of these will contain two sub-elements, one
being "name" containing the name of the media file, and one being "data"
which contains the data in hexadecimal form. At the time of writing the
media assets which may be associated with an event include images called
"square", "landscape", "triplet_one", "triplet_two", "triplet_three", 
"triplet_four", "triplet_five", "marquee", "seating_plan".

.. hint::
    - If the source information was requested using "source\_info" then a number of extra elements may be present in the output. 
    - The terms and conditions element is always included


Example output
~~~~~~~~~~~~~~

.. code-block:: xml

    <extra_info_result>
    <event_desc>Maria Pages</event_desc>
    <venue_desc>Sadlers Wells</venue_desc>
    <source_desc>Keith Prowse Ticketing</source_desc>
    <source_code>fcg1</source_desc>
    <country_code>uk</country_code>
    <geo_data>
    <latitude>51.52961137</latitude>
    <longitude>-0.10601562</longitude>
    </geo_data>
    <venue_info>The world's No.1 venue dedicated to international
    dance - presenting dance in all forms from contemporary to flamenco,
    ballet to hip hop and more.

    Nearest Underground: Angel (Northern line)
    Nearest Rail: Kings Cross (Northern line to Angel)
    Turn left out of Angel station and cross the road at the
    crossroads for St John Street. Roseberry Avenue is on the right
    with the theatre about 100 metres down on the right.</venue_info>
    <venue_addr>Rosebery Avenue
    Islington
    London</venue_addr>
    </extra_info_result>

Potential failure codes
-----------------------

- **1** - the supplied crypto block was not generated by
   "event\_search"

- **2** - the requested "mime\_text\_type" was not a supported value

- **101** - no "event\_token" has been supplied

- **102** - the supplied "event\_token" is corrupt

- **103** - the event specified could not be found in the database