Due to PCI compliant reasons we're going to turn off support for TLS v1.0 on all of our servers.
Please check/update you API implementations to support TLS v1.2 until 29.06.2018

REST API Formats

From XING Events Developer Documentation
Jump to: navigation, search

String

The String class represents character strings and will always use the UTF-8 encoding

Integer

An integer value can hold values from 2^31-1 to -2^31.

Date

Date values are represented using the ISO 8601 format (e.g. 2020-01-01T00:00:00). Timezone information is always ignored since it is given as a separate timezone field

Double

A field holding a floating point value with double precision.

Boolean

A field holding a boolean value: either true or false.

Timezones

Timezones are used to specify where the user / the event is located. All other times (start date of the event etc) are then relative to the selected timezone. The following timezones are supported:

Etc/GMT+12
Pacific/Midway
US/Hawaii
US/Alaska
America/Los_Angeles
US/Mountain
US/Arizona
US/Central
Canada/Saskatchewan
America/Mexico_City
US/Eastern
US/East-Indiana
America/Bogota
Canada/Atlantic
America/Caracas
America/Santiago
Brazil/East
America/Buenos_Aires
Etc/GMT+2
Atlantic/Azores
Europe/London
Africa/Casablanca
Europe/Belgrade
Europe/Sarajevo
Europe/Paris
Europe/Berlin
Europe/Bucharest
Africa/Cairo
Europe/Helsinki
Europe/Athens
Asia/Jerusalem
Africa/Harare
Europe/Moscow
Asia/Baghdad
Africa/Nairobi
Asia/Muscat
Asia/Baku
Asia/Yekaterinburg
Asia/Karachi
Asia/Kolkata
Asia/Almaty
Asia/Colombo
Asia/Bangkok
Asia/Hong_Kong
Asia/Singapore
Asia/Taipei
Australia/Perth
Asia/Seoul
Asia/Tokyo
Asia/Yakutsk
Australia/Canberra
Australia/Brisbane
Australia/Hobart
Asia/Vladivostok
Pacific/Guam
Asia/Magadan
Pacific/Fiji
Pacific/Auckland

Language

Languages can be used to specify the language of the event or may be returned to tell what language a purchase was made in. The following languages are supported:

de    German
en    English
fr    French
es    Spanish

Money

All money types are integers and conform to its smallest currency unit. For example, if the ticket shop currency is euros (EUR), the values of money fields conform to euro cents. So an amount of EUR 20,55 is represented as 2055.

Note: in contrast to all other currencies, no monetary subunit exists for KRW and JPY, so KRW 100 will be represented as 100 (not 10000).

Percentage

All percentage types are represented as integers times 100. For example, if the ticket shop VAT is 19%, the values of percentage fields will be represented as 1900.

Currency

Currencies are encoded using the ISO 4217 currency format. The following currencies are supported:
AUD, BRL, CAD, CHF, CZK, CNY, DKK, EUR, GBP, HKD, HUF, INR, JPY, KRW, NOK, NZD, PLN, QAR, SEK, SGD, USD, ILS, RON, MYR, THB, TWD, ZAR

Note: in contrast to all other currencies listed here, no monetary subunit exists for KRW and JPY

Country

Country codes are defined by the ISO 3166-1-alpha-2 code standard. You can find the complete list here: Online Browsing Platform of iso.org

A few examples:

DE — Germany
ES — Spain
FR — France
GB — Great Britain
US — USA
...

State

For the country "United States" the state should also be provided. The state codes are defined by the ISO 3166-2 code standard (without the "US-" prefix). The "outlying areas" (e.g. American Samoa, Guam,..) are not supported as they are listed as own countries. You can find the complete list here: ISO 3166:US by iso.org.

A few examples:

AL — Alabama
AK — Alaska
AZ — Arizona
AR — Arkansas
CA — California
...

EventTypeEnum

A constant defining the type of the event Accepted values:

EVENT_TYPE_CONFERENCE
EVENT_TYPE_SEMINAR
EVENT_TYPE_BUSINESS_MEETING
EVENT_TYPE_CORPORATE_EVENT
EVENT_TYPE_EXHIBITION
EVENT_TYPE_CONCERT
EVENT_TYPE_PRIVATE
EVENT_TYPE_OTHER

IndustryEnum

Industry of the event Accepted values:

CATEGORY_ARCHITECTURE_PLANNING 
CATEGORY_CONSUMER_GOODS 
CATEGORY_AUTOMOTIVE 
CATEGORY_INDUSTRIAL_AUTOMATION 
CATEGORY_MEDICAL_SERVICES 
CATEGORY_ENVIRONMENT 
CATEGORY_LOGISTICS_SUPPLY_CHAIN 
CATEGORY_TOURISM 
CATEGORY_INFORMATION_TECHNOLOGY_SERVICES 
CATEGORY_TELECOMMUNICATION 
CATEGORY_MEDIA 
CATEGORY_FINANCE 
CATEGORY_INSURANCE 
CATEGORY_REAL_ESTATE 
CATEGORY_TAX_ACCOUNTANCY_AUDITING 
CATEGORY_MANAGEMENT_CONSULTING 
CATEGORY_MARKETING 
CATEGORY_HR 
CATEGORY_CIVIL_SERVICE 
CATEGORY_EDUCATION 
CATEGORY_PUBLIC_HEALTH 
CATEGORY_ENTERTAINMENT 
CATEGORY_OTHER

DisciplineEnum

The discipline of the attendees you target Accepted values:

CONTROLLING_AND_PLANNING
ANALYSIS_AND_STATISTICS
ADMINISTRATION
CONSULTING
CUSTOMER_SERVICE
PURCHASING_AND_LOGISTICS
FINANCE_ACCOUNTING_CONTROLLING
TEACHING
HEALTH_MEDICAL_SOCIAL
GRAPHIC_DESIGN_AND_ARCHITECTURE
ENGINEERING_AND_TECHNICAL
IT_AND_SOFTWARE_DEVELOPMENT
MANAGEMENT_AND_CORPORATE_DEVELOPMENT
MARKETING_AND_ADVERTISING
HR
PR_AND_JOURNALISM
PRODUCTION_AND_MANUFACTURING
PRODUCT_MANAGEMENT
PROJECT_MANAGEMENT
PROCESS_PLANNING_AND_QA
LAW
SALES_AND_COMMERCE
OTHER_DISCIPLINES

EmploymentStatusEnum

The employment of the attendees you target Accepted values:

FULL_TIME 
PART_TIME 
INTERN 
FREELANCER_SELF_EMPLOYED 
OWNER 
PARTNER_SHAREHOLDER 
BOARD_MEMBER 
VOLUNTEER 
SELF_EMPLOYED 
SHAREHOLDER 
CIVIL_SERVANT 
RECRUITER 
FREELANCER 
PARTNER

CareerLevelEnum

The career level of the attendees you target Accepted values:

STUDENT_INTERN 
ENTRY_LEVEL 
PROFESSIONAL_EXPERIENCED 
MANAGER_SUPERVISOR 
EXECUTIVE 
SENIOR_EXECUTIVE

GuestListVisibilityEnum

The visibility options for the guest list on the event page on XING. Accepted values:

XING_MEMBERS
INVITED
ORGANIZER

CallToActionEnum

The visibility options for the guest list on the event page on XING. Accepted values:

GET_TICKET 
BUY_TICKET 
REGISTER_NOW 
BOOK_NOW 
SIGN_UP_NOW 
REGISTER_FOR_FREE 
GET_FREE_TICKET

AccessibilityEnum

If your event location is accessible (wheelchair friendly) Accepted values:

UNSELECTED
UNKNOWN
YES
NO

CancellationOptionEnum

Possible options for the cancellation settings of an event Accepted values:

NotAllowed
ProcessedByHost
ProcessedByAmiando
ProcessedByAmiandoFeesPaidByOrganizer


REST API Contents
Getting Started Get your API key Overview Formats Errors
Data Types Event Participant Payment Ticket
Ticket Categories ProductDefinition Products CodeDefinition
TicketShop Addresses Ticket Types Payment Types
BankAccount UserDataDefinition UserData User
ApiKey
Data Synchronization Sync Interface