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 ErrorCodes

From XING Events Developer Documentation
Jump to: navigation, search

This page contains the complete list of Errorcodes returned by the REST API.

Contents

Error response format

If an error occurred while processing the request, one or more errors will be returned in following format.

{"errors":[<error1>, <error2>],"success":false}

For example

{
  "errors":
  ["com.amiando.api.rest.MissingParam.hostId"],
  "success":false
}

General Errorcodes

Not authorized

Error com.amiando.api.rest.NotAuthorized
HTTP Status 403
Description You tried to access an object where you do not have the necessary permissions.
Solution See the API key details to learn more about API keys and permissions.

Invalid API key

Error com.amiando.api.rest.InvalidApiKey
HTTP Status 403
Description You provided an invalid api key.
Solution See How to get your API Key

Missing parameter

Error com.amiando.api.rest.MissingParam.<param>
HTTP Status 400
Description You didn't provide a required parameter.

Invalid format

Error com.amiando.api.rest.InvalidFormat.<property>
HTTP Status 400
Description The format of the property is not correct (for example: a date field).
Solution See Formats.

Invalid param

Error com.amiando.api.rest.InvalidParam.<property>
HTTP Status 400
Description The parameter <property> you provided is not valid for this request.
Solution Provide only one parameter.

Invalid path

Error com.amiando.api.rest.InvalidPath
HTTP Status 404
Description You specified an invalid url or used the wrong REST method in your call (GET versus POST).
Solution See the Basics.

Invalid version

Error com.amiando.api.rest.InvalidVersion
HTTP Status 400
Description You are using an invalid version or missing the version parameter.
Solution See the Basics.

Object not found

Error com.amiando.api.rest.ObjectNotFound
HTTP Status 404
Description The object you requested could not be found.
Solution Make sure the object ID you provided is correct.

Invalid Resource ID

Error com.amiando.api.rest.InvalidResourceId
HTTP Status 400
Description The resource ID you specified in a read or update request was not a number. Maybe you used GET with a .../create-Request?
Solution See the Basics.

Internal server exception

Error com.amiando.api.rest.InternalServerException.<error id>
HTTP Status 500
Description An internal error has occurred on our server. Please contact api@xing-events.com using the returned error id to report this error.

Data Processing Agreement Missing

Error com.amiando.api.rest.DataProcessingAgreementMissing
HTTP Status 403
Description For some calls you need to sign a "data processing agreement". Please contact our support or your account manager if you didn't sign this agreement yet.

User Errorcodes

Required field missing

Error com.amiando.User.<Field>Required
HTTP Status 400
Description You are trying to create or to update an user object and didn't provide the property <field>.
NOTE: If you get the Errorcode com.amiando.User.IdentifierRequired, you didn't provide the property username.

Insecure connection

Error com.amiando.api.rest.InsecureConnection
HTTP Status 403
Description You called a method that has a user password as parameter. For security reasons, this method only works using a secure connection.
Solution Use https.

Invalid password

Error com.amiando.api.rest.InvalidPassword
HTTP Status 400
Description The password you've sent doesn't match the user.

Invalid sign up promotion code

Error com.amiando.api.rest.InvalidSignUpPromotionCode
HTTP Status 400
Description You are trying to create a user object, but the sign up promotion code was incorrect. The user was not created.

No multi user key

Error com.amiando.api.rest.NoMultiUserKey
HTTP Status 400
Description You are trying to request permission with an API key that already has a user permission and that is not a multi-user-API key.

Event Errorcodes

Already Activated

Error com.amiando.Event.AlreadyActivated
HTTP Status 400
Description You tried to activate an event, which has already been activated before.

Event date in the past

Error com.amiando.Event.DateIsPast
HTTP Status 400
Description The date of the event can not be in the past.

End date before date

Error com.amiando.Event.EndDateBeforeDate
HTTP Status 400
Description The end date of the event is before the start date.

No Language

Error com.amiando.Event.NoLanguage or com.amiando.User.NoLanguage
HTTP Status 400
Description The object or user has no language set.

Unsupported Language

Error com.amiando.Event.UnsupportedLanguage or com.amiando.User.UnsupportedLanguage
HTTP Status 400
Description The language you provided is not supported by XING Events.
Solution See the datatype Language for supported values.

No Country

Error amiando.Event.NoCountry
HTTP Status 400
Description The event has no country set

Unsupported Country

Error amiando.Event.UnsupportedCountry
HTTP Status 400
Description The country code you provided is invalid.
Solution See the datatype Country for supported values.

No Timezone

Error com.amiando.Event.NoTimezone
HTTP Status 400
Description The event has no timezone set.

No Title

Error com.amiando.Event.NoTitle
HTTP Status 400
Description The event has no title set.

No Ticket Categories

Error com.amiando.TicketShop.NoTicketCategories
HTTP Status 400
Description The event has no ticket categories defined yet.
Use TicketCategory Create to add categories to your event.

No Billing Address

Error com.amiando.TicketShop.NoBillingAddress
HTTP Status 400
Description The event has no billing address defined yet.

No Bank Account

Error com.amiando.TicketShop.NoBankAccount
HTTP Status 400
Description The event has no bank account defined yet.

No Payment Type

Error com.amiando.TicketShop.NoPaymentType
HTTP Status 400
Description The event has no payment types (credit-card, invoice, etc.) defined yet.

No Ticket Type

Error com.amiando.TicketShop.NoTicketType
HTTP Status 400
Description The event has no ticket types (e-ticket, paper, etc.) defined yet.

Identifier exists

Error com.amiando.Event.IdentifierExists
HTTP Status 400
Description You're trying to update the public event identifier, but the value is already in use.

Invalid visibility

Error com.amiando.api.rest.InvalidVisibility
HTTP Status 400
Description You're trying to update the property visibility, but the value you provided was invalid.

Ticketshop Errorcodes

Can't change currency

Error com.amiando.ticketShop.cantChangeCurrency
HTTP Status 400
Description You can't change the currency of a ticket shop, if the event is not in demo mode anymore and has already sold tickets.

Partner Errorcodes

No name

Error com.amiando.Partner.NoName
HTTP Status 400
Description The partner has no name set.

No language

Error com.amiando.Partner.NoLanguage
HTTP Status 400
Description The object has no language set.

Unsupported language

Error com.amiando.Partner.NoLanguage
HTTP Status 400
Description The language you provided is not supported by XING Events.
Solution See the datatype Language for supported values.

No country

Error com.amiando.Partner.NoCountry
HTTP Status 400
Description The partner has no country set.

Invalid country

Error com.amiando.Partner.InvalidCountry
HTTP Status 400
Description The country code you provided is invalid.
Solution Allowed values for Country are: “DE”, “CH”, “AT”, “GB”, “FR”, “ES”, “SE”, “NN” (other Countrys).

Partner already exists

Error com.amiando.Partner.PartnerAlreadyExists
HTTP Status 400
Description You tried to create a partner with a api key that was already connected to a partner.
Solution Get a new api key

Participant Errorcodes

Invalid devaluation source

Error com.amiando.api.rest.InvalidDavaluationSource.<property>
HTTP Status 400
Description The value you provided as source does not exist.
Solution Do not provide this optional parameter or use on the following valid source values: SEARCH, PASSBOOK, MOBILE_TICKET, ETICKET, PAPER_TICKET

User field Errorcodes

Invalid Gender

Error com.amiando.api.rest.InvalidGender
HTTP Status 400
Description The value you provided for a gender user field is not valid.
Solution The gender user field accepts the values 1, 2 or MALE, FEMALE.

Invalid Country

Error com.amiando.api.rest.InvalidCountry
HTTP Status 400
Description The value you provided for a country user field is not valid.
Solution See the datatype Country for supported values.

Invalid Date

Error com.amiando.api.rest.InvalidDate
HTTP Status 400
Description The value you provided for a date type user field is not valid.
Solution See the datatype Date for supported values.

Invalid Number

Error com.amiando.api.rest.InvalidDate
HTTP Status 400
Description The value you provided for a number type user field is not valid.
Solution See the datatype Formats for supported values.

Invalid Option

Error com.amiando.api.rest.InvalidOption
HTTP Status 400
Description The value you provided for a dropdown or radio button type user field is not valid.
Solution You must specify a value that exists as option in this user field (you should provide the options key, but can also provide the options name).

Invalid Number

Error com.amiando.api.rest.InvalidDate
HTTP Status 400
Description The value you provided for a number type user field is not valid.
Solution See the datatype Formats for supported values.

Payment Errorcodes

Amount below zero

Error com.amiando.ticketing.TicketShop.AmountBelowZero
HTTP Status 400
Description You provided an amount of tickets that is less than zero.

Too many items

Error com.amiando.ticketing.TicketShop.TooManyItems
HTTP Status 400
Description You provided an amount of tickets that is greater than the number of avalible tickets.

Below min sell

Error com.amiando.ticketing.TicketShop.BelowMinSell
HTTP Status 400
Description You provided an amount of tickets that is less than the minimum for this category.

Exceeded max sell

Error com.amiando.ticketing.TicketShop.ExceededMaxSell
HTTP Status 400
Description You provided an amount of tickets that exceeded the maximum for this category.

Tickets required

Error com.amiando.Payment.TicketsRequired
HTTP Status 400
Description You tried to start a payment without selecting any ticket.

Cannot update non draft payment

Error com.amiando.api.rest.CannotUpdateNonDraftPayment
HTTP Status 400
Description You tried to update a payment that is not in draft mode.

Discount code used up

Error com.amiando.api.rest.DiscountCodeUsedUp
HTTP Status 400
Description You tried to apply a discount code, that is used up.

Data prefilled

Error com.amiando.api.rest.DataPrefilled
HTTP Status 400
Description This payment has already data prefiled.

Invalid discount code

Error com.amiando.api.rest.InvalidDiscountCode
HTTP Status 400
Description You tried to apply a discount code, that is invalid.

Discount code required

Error DiscountCodeRequired
HTTP Status 400
Description You tried to buy a ticket form a category, that is hidden by a discount code.

Payment Has No Zero Amount

Error com.amiando.api.rest.PaymentHasNoZeroAmount
HTTP Status 400
Description You can only finalize payments that have a total amount of 0. Apply a 100% discount code first if you want to import a payment with paid tickets.

Terms And Conditions Must Be Accepted Exception

Error com.amiando.api.rest.TermsAndConditionsMustBeAcceptedException
HTTP Status 400
Description acceptedTermsAndConditions parameter must be set to "1" or "true" to signal that you are allowed to do this import in the name of the person you provided in the payment.

Missing Buyer Address

Error com.amiando.api.rest.BuyerAddressMissing
HTTP Status 400
Description You tried to charge a paymetn without a buyerAdress.

CreditCard Payment Not Enabled

Error com.amiando.api.rest.CreditCardPaymentNotEnabled
HTTP Status 400
Description You tried to charge a payment with creditcard an this feature ist not enabled for your event.

Insecure Connection

Error com.amiando.api.rest.InsecureConnection
HTTP Status 400
Description You tried to send a request over http an not as required over https.

Method Not Allowed

Error com.amiando.api.rest.MethodNotAllowed
HTTP Status 400
Description You tried to mark a payment as paid that is handled by XING Events. Only payments that used a payment option handled by the organizer can be marked as paid.

Ticket Category Errorcodes

Name missing

Error com.amiando.TicketCategory.NameMissing
HTTP Status 400
Description You tried to create or update a ticket category without a name.

Price missing

Error com.amiando.TicketCategory.PriceMissing
HTTP Status 400
Description You tried to create or update a ticket category without a price.

Price too low

Error com.amiando.TicketCategory.PriceTooLow
HTTP Status 400
Description You tried to create or update a ticket category with a price that is too low.

No tickets available

Error com.amiando.TicketCategory.NoTicketsAvailable
HTTP Status 400
Description You tried to create or update a ticket category with 0 tickets.

Invalid max sell

Error com.amiando.TicketCategory.InvalidMaxSell
HTTP Status 400
Description You provided a number for max sell, that is below 1.

Max sell lower than min sell

Error com.amiando.TicketCategory.MaxSellLowerThanMinSell
HTTP Status 400
Description You provided a number for max sell, that is lower than the min sell.

Ticket sales span is too big

Error com.amiando.TicketCategory.TicketSaleSpanIsTooBig
HTTP Status 400
Description You difference between maxSell and minSell is too big. maxSell - minSell must not be greater then 500.

Sale end before sale start

Error com.amiando.TicketCategory.SaleEndBeforeSaleStart
HTTP Status 400
Description You provided a end date that is before the start date.

Comment too long

Error com.amiando.TicketCategory.CommentTooLong
HTTP Status 400
Description You provided a comment that is too long.

Cant edit price

Error com.amiando.api.rest.CantEditPrice
HTTP Status 400
Description You tried to update the price of a category whose associated event is not in demo mode and tickets where already sold.

Email Errorcodes

No HTML content allowed

Error com.amiando.api.rest.NoHtmlContentAllowed
HTTP Status 400
Description You tried to set the htmlContent of a plaintext email.

No text content allowed

Error com.amiando.api.rest.NoHtmlContentAllowed
HTTP Status 400
Description You tried to set the textContent of a template email.

Error on evaluating template

Error com.amiando.api.rest.ErrorOnEvaluatingTemplate
HTTP Status 400
Description An error on evaluating the template. Maybe you provided an invalid template name.

Error on sending

Error com.amiando.api.rest.ErrorOnSending
HTTP Status 500
Description An error occurred while sending the email.

No HTML content given

Error com.amiando.campaign.Campaign.noHtmlContentGiven
HTTP Status 400
Description There is no text in your HTML content.

No unsubscribe link

Error com.amiando.campaign.Campaign.noUnsubscribeLink
HTTP Status 400
Description You forgot to include the unsubscribe link ([%unsubscribe%]).

Email invalid

Error com.amiando.User.EmailInvalid
HTTP Status 400
Description You provided an invalid email address.

TicketType Errorcodes

TicketType not allowed

Error com.amiando.api.rest.ticketType.TicketTypeNotAllowed
HTTP Status 400
Description This type is not allowed for the event.

TicketType already exists

Error com.amiando.api.rest.ticketType.TicketTypeAlreadyExists
HTTP Status 400
Description This type already exists. You have to update the existing one to activate it.

PaymentType Errorcodes

PaymentType not allowed

Error com.amiando.api.rest.paymentType.PaymentTypeNotAllowed
HTTP Status 400
Description This type is not allowed for the event.

PaymentType already exists

Error com.amiando.api.rest.paymentType.PaymentTypeAlreadyExists
HTTP Status 400
Description This type already exists. You have to update the existing one to activate it.

Discount code Errorcodes

Discount Code Exists

Error com.amiando.api.rest.DiscountCodeExistsException
HTTP Status 400
Description You tried to add a code to the CodeDefinition that already exists in this event.


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
Partner ApiKey
Data Synchronization Sync Interface