Skip to content

From version 4.147 onwards

Enhancements from Version 4.147

With version 1.147, the Attendee API has been extended with several smaller enhancements to the response payload.

Below is a list of all the new fields that have been added in this version.

Summary of changes

Three areas of the ticket payload were extended in this version:

  • AdditionalArticlesInformation (new object) — Enriched article metadata directly on the ticket: article names in German and English, up to 10 free-text info columns, and a TicketValidityType flag (0 = Sub-event, 1 = Day ticket, 8 = Season/permanent ticket). Access requires the new Extended Article Right.

  • OrderPosition (new object) — The specific order-line position linked to the ticket, including its internal and unique IDs, distribution chain type, up to 10 custom fields, and up to 3 external reference IDs.

  • VoucherCampaigns (new object) — Voucher and campaign data tied to the purchase: voucher code, campaign name, internal campaign ID, value, and quota settings.

  • AdditionalSalesInformation (extended) — Four new properties added to the existing object: Id, DistributionChainType, AccountPeriodInternalId, and AffiliateId.

  • Use Case – Delta Sync - change defaultlimit to 500 (from 2500)


New top-level objects on the ticket payload

AdditionalArticlesInformation (new object)

Provides enriched article metadata directly on the ticket. Requires the new Extended Article Right to be granted.

PropertyDescription
articleName_DEArticle name in German
articleName_ENArticle name in English
articleInfo1 – articleInfo10Free-text info columns (up to 10)
ticketValidityTypeValidity scope: 0 = Sub-event · 1 = Day ticket · 8 = Season/permanent ticket

OrderPosition (new object)

Represents the specific order-line position associated with the ticket.

PropertyDescription
idInternal order-position identifier
uniqueIdGlobally unique identifier for the position
distributionChainTypeSales/distribution channel classification
customField1 – customField10Configurable custom fields (up to 10)
externalId1 – externalId3External reference identifiers (up to 3)

VoucherCampaigns (new object)

Returns voucher and campaign data linked to the ticket purchase.

PropertyDescription
voucherCodeThe redeemed voucher code
voucherCampaignInternalIdInternal campaign identifier
voucherCampaignNameHuman-readable campaign name
voucherCampaignValueMonetary or percentage value of the voucher
voucherCampaignQuotaValueQuota limit value of the campaign
voucherCampaignQuotaModeQuota enforcement mode

Extended existing object

AdditionalSalesInformation (extended)

This object already existed. The following properties have been added in v4.147:

PropertyDescription
idInternal sale-information identifier
distributionChainTypeSales/distribution channel classification
accountPeriodInternalIdInternal accounting period reference
affiliateIdAffiliate partner identifier