Skip to main content

Get an entire specific Order

GET 

/order/:guid

Retrieve an entire specific Order. This includes, all Tickets, Products, OrderMetaData, Payments, Returns, and Refunds.

Note that only the publicaly applicable properties are present. Since this call does not require any kind of authentication. The Returns will only be visible to authenticated users.

Request

Path Parameters

    guid stringrequired

    The guid of the Order.

Responses

Order found.

Schema

    guid uuid

    The guid of the Order.

    purchase_channel string

    The channel through which the Order is purchased.

    finn_original_price integer

    The original price, i.e. the price of the Order before any CouponCodes have been applied.

    finn_value integer

    The value of the Order used when deriving the service fees. This is the price that is paid for the Order, i.e. the sum of the values of the Tickets of the Order.

    finn_service_fee integer

    The service fees of the Order. This is calculated upon the value.

    finn_price integer

    The total price of the Order. This is the sum of the value, and service fees.

    shop_id uuid

    The guid of the Shop associated with the Order.

    is_seated boolean

    Whether any of the Tickets of the Order is seated.

    email email

    The email address of the Receiver.

    send_email boolean

    Whether to send the PDF to the visitor.

    is_complete boolean

    Whether the Order is complete, i.e. whether all required OrderMetaData is filled in.

    has_receipt boolean

    Whether the Order has a receipt.

    pdf_rendered boolean

    Whether the PDF has been rendered.

    status string

    The status of the Order.

    amount integerdeprecated

    Replaced by the finn values.

    transaction_fee integerdeprecated

    Replaced by the finn values.

    invalidated_since ISO 8601

    The date at which this Order was invalidated.

    invalidated_reason string

    The reason why this Order was invalidated.

    firstName string

    The first name of the Receiver.

    lastName string

    The last name of the Receiver.

    locale IETF BCP 47

    The locale of the Receiver.

    fullname string

    The full name of the Receiver

    download_link url

    The link where the Order can be downloaded.

    download_ready boolean

    Whether the Order can be downloaded.

    receipt_link url

    The link to the receipt of the Order.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    created_at_int integer

    The time it was created at as a unix timestamp.

    shop

    object

    guid uuidrequired

    The guid of the Shop.

    name stringrequired

    Possible values: <= 255 characters

    The name of the Shop.

    description string

    Possible values: <= 65536 characters

    The description of the Shop.

    event_selection string

    Possible values: [auto, enabled, disabled]

    Default value: auto

    Whether to show the Event selection as first step in the Shop. On default this will be enabled if there are 5 or more Events available.

    google_tag string

    Possible values: >= 8 characters and <= 15 characters

    A Google Tag code from Google Tag Manager to include in the Shop.

    company_terms url

    The terms of the Company of the Shop. This is a url.

    css string

    Any custom css the Shop has.

    facebook_auto_attend boolean

    Whether people should be auto-attended or not, when they are logging in with Facebook.

    facebook_page_url url

    The full url to the Facebook Page. This will be shown in shop as header.

    seats_allow_orphan boolean

    Whether for seats, orphan seats are allowed.

    greedy_date_selection boolean

    Whether a date should be preselected. When set to true, the shop always falls back to date-selection mode.

    email_validation_rule string

    Extra rules which can be enforced on the emails when placing Orders, i.e. Laraval validation rules.

    email_must_be_unique boolean

    Whether all emails should be unique, i.e. only 1 Order can be placed with the same email address.

    auto_prune boolean

    Whether to allow auto pruning.

    global_terms url

    Calculated property, the Whitelabel terms a visitor has to accept.

    currency ISO 4217

    Default value: EUR

    Currency for the Orders, currently ignored.

    reservation_time integer

    Possible values: <= 3600

    How long reserved Tickets and/or Products remain reserved. The time is in minutes.

    seats_public_key string

    The public key to use with Seats.io.

    tickets

    object[]

  • Array [

  • guid uuid

    The guid of the Ticket.

    finn_original_price integer

    The original price, i.e. the minimum price of the Ticket Type.

    finn_value integer

    The value of the Ticket used when deriving the service fees. This is the price that is paid for the Ticket, i.e. the sum of the inner values of the Products minus its own inner value.

    finn_inner_value integer

    The actual value of the Ticket, i.e. the sum of the values of the Products of this Ticket.

    finn_service_fee integer

    The service fees of the Ticket. This is calculated based upon the value.

    finn_price integer

    The total price of the Ticket, i.e. the sum of the value, inner value, and service fees.

    ticket_number string

    The barcode of the Ticket.

    is_complete boolean

    Whether the Order is complete, i.e. whether all required OrderMetaData is filled in.

    retrievable_after integer

    After this unix timestamp the Ticket is downloadable by the visitor.

    price integerdeprecated

    Replaced by the finn values.

    service_fee integerdeprecated

    Replaced by the finn values.

    download_link string

    The link where the PDF of the Ticket can be downloaded.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    invalidated_since ISO 8601

    The date at which this was invalidated.

    invalidated_reason string

    The reason why this was invalidated.

    created_at_int integer

    The time it was created at as a unix timestamp.

    ticket

    object

    guid uuidrequired

    The guid of the the Ticket Type.

    company_id uuid

    The guid of the Company associated with the Ticket Type.

    event_id uuidrequired

    The guid of the Event associated with the Ticket Type.

    name stringrequired

    Possible values: <= 255 characters

    The name of the Ticket Type.

    description string

    Possible values: <= 65536 characters

    The description for the Ticket Type.

    min_price integer

    Possible values: <= 999999

    The minimum price of this Ticket Type in cents, overwrites the mandatory Product Type prices.

    vat_percentage float

    Possible values: <= 100

    The VAT percentage which applies to this Ticket Type. This is a float with at most 2 decimals, because VAT percentages in some countries have fractions of a percent.

    late_personalization boolean

    Whether the Metadata within the Ticket Type can be LatePersonalized. When true MetaData is not asked in Shop but before download.

    status_overrule string

    Possible values: [auto, sold_out]

    One can overwrite the status for a Ticket Type here.

    class string

    Possible values: [EventProtect, RefundProtect, RandomNumberGenerator, PlayPass, Co2Compensate, Giro555]

    Which class the Ticket Type needs to trigger after for example a Payment.

    increment integerrequired

    Possible values: >= 1

    Default value: 1

    The Ticket Type can only be ordered in groups of this size, i.e. the count of ordered Ticket Types needs to be exactly divisible by this number. This should be less or equal to min_orderable_amount_per_order.

    available_from ISO 8601

    The start of the availability range for this Ticket Type. Has to be set when available_until is set.

    available_until ISO 8601

    The end of the availability range for this Ticket Type. Has to be set when available_from is set.

    availability_margin integer

    Possible values: <= 999999999

    The margin for which the Ticket Type will show-up (with countdown for example) in the Shop.

    min_orderable_amount_per_order integer

    Possible values: >= 1

    Default value: 1

    Specifies the minimum number of Ticket Types a visitor can select within one Order. This should be less or equal to max_orderable_amount_per_order.

    max_orderable_amount_per_order integer

    Possible values: <= 250

    Default value: 20

    Specifies the maximum number of Ticket Types a visitor can select within one Order. This should be greater or equal to min_orderable_amount_per_order.

    percentage_service_costs_in_ticket integerdeprecated

    Possible values: <= 100

    How many fees will be in the Ticket Type.

    seats_category_key integer

    Possible values: <= 255

    The category key from the Chart where the Ticket Type should be applied to (see Seats.io).

    hide_without_coupon boolean

    Default value: false

    Whether to hide this Ticket Type when no Coupon is used.

    combines_products boolean

    Default value: true

    Whether to combine the Products into the Ticket Type price or not. If false, Products show up separately on the receipt/invoices.

    swappable boolean

    Default value: true

    Whether it is possible to swap the Ticket Type.

    available_in_cashr booleandeprecated

    Default value: false

    Whether a Ticket Type is available in Cashr.

    status string

    Possible values: [sold_out, not_sold_right_now, available]

    The sale status of the Ticket Type.

    seated boolean

    Whether a Ticket Type is seated or not.

    include_service_cost_in_price booleandeprecated

    Whether to include the service costs into the price.

    event

    object

    guid uuidrequired

    The guid of the Event.

    company_id uuid

    The guid of the Company the Event belongs to.

    location_id uuid

    The guid of the Location the Event belongs to.

    event_refund_setting_id uuid

    The guid of the EventRefundSetting of the Event.

    name stringrequired

    Possible values: <= 255 characters

    The name of the Event.

    description string

    Possible values: <= 65536 characters

    The description of the Event.

    email_info string

    Possible values: <= 1000 characters

    Extra information added to the email sent to ticket buyers.

    type stringrequired

    Possible values: [once, repeating]

    The type of the Event. This is either "repeating" or just "once".

    status stringrequired

    Possible values: [disabled, normal, sold_out, refunding, moving]

    Default value: normal

    The current status of sale or refund of the Event. One can set the status of a Ticket Type here.

    visitor_contact_email email

    Possible values: <= 255 characters

    Contact email for visitors.

    visitor_contact_phone phoneNumber

    Possible values: <= 255 characters

    Contact phone for visitors.

    visitor_contact_url string

    Possible values: <= 255 characters

    Contact url for visitors.

    website url

    Possible values: <= 255 characters

    The website of the Event.

    locale IETF BCP 47required

    The locale of the Event.

    currency ISO 4217required

    The currency of the Event

    category string

    The category of the Event.

    subcategories string[]

    The subcategories of the Event.

    retrievable_after ISO 8601

    The date after which the Ticket Types of this Event may be retrieved.

    auto-prune boolean

    Whether to automatically remove Events from the Shops.

    location

    object

    guid uuidrequired

    The guid of the Location

    company_id uuid

    The guid of the Company of the Location.

    name stringrequired

    Possible values: <= 255 characters

    The name of the Location.

    description string

    Possible values: <= 65535 characters

    The description of the Location.

    capacity integerrequired

    Possible values: <= 9999999999

    The maximum capacity of people that can be at this Location. This number is strictly positive or 0 signaling an infinite capacity.

    latitude float

    Possible values: >= -85 and <= 85

    The latitude in LatLng format.

    longitude float

    Possible values: >= -180 and <= 180

    The longitude in LatLng format.

    address string

    Possible values: <= 65536 characters

    The address of this Location. This is free text, so it can be as large or small as desired.

    public boolean

    Whether this Location should appear in the public listing.

    seats_chart_key string

    The key of the seating chart. See Seats.io for more information.

    parent_guid uuid

    The guid of the parent Location. In the case that the Location has a parent.

    seated boolean

    Whether the Location provides seating or not.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    deleted_at ISO 8601

    The time it was deleted.

    start ISO 8601

    The start of the date range.

    end ISO 8601

    The end of the date range. Must be later than start date.

    refundSetting

    object

    guid uuid

    The guid of the EventRefundSetting.

    event_id uuid

    The guid of the Event the EventRefundSetting belongs to.

    created_by_user_id uuid

    The guid of the User that created the EventRefundSetting.

    refund_fees boolean

    Default value: true

    Whether we need to Refund service fees.

    refund_transaction_fees boolean

    Default value: true

    Whether we need to Refund transaction fees.

    refund_donate_enabled boolean

    Default value: false

    Whether the visitor should be given the choice to donate the Refund to the organisation.

    refund_donate_options string

    Possible values: <= 255 characters

    The available donate options for the visitor to donate the Refund.

    refund_message string

    Possible values: <= 65536 characters

    Message for communication from the organiser to the visitor.

    refund_send_email boolean

    Default value: true

    Whether the visitors receive an email when the Refund process starts.

    status_until ISO 8601

    The time for which the refunding or moving state ends and fallbacks to be available.

    status_refundable_before ISO 8601

    The time before which tickets must have been bought, in order to be eligible for refunding.

    refundable_by_payment boolean

    Whether the Refund can be paid by payment.

    refundable_by_voucher boolean

    Whether the Refund can be paid by voucher.

    refundable_default string

    Possible values: [payment, voucher]

    The default in which the Refund will be paid.

    voucher_multiplier float

    Possible values: <= 5

    The multiplier applied to the voucher.

    voucher_end_date_type string

    Possible values: [offset, date]

    The type of how the end date of the voucher is determined.

    generate boolean

    Default value: true

    Whether to automatically generate the EventRefundActions or not.

    voucher_end_date_value string

    The end date for which the voucher will be valid.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    payoutProfile

    object

    guid uuidrequired

    The guid of the PayoutProfile.

    company_id uuidrequired

    The guid of the Company the PayoutProfile belongs to.

    name stringrequired

    Possible values: >= 3 characters and <= 255 characters

    The name of the PayoutProfile.

    refundable_by_payment booleandeprecated

    ignore will be removed on new update.

    refundable_by_voucher booleandeprecated

    ignore will be removed on new update.

    refundable_default stringdeprecated

    Possible values: [payment, voucher]

    ignore will be removed on new update.

    voucher_multiplier floatdeprecated

    ignore will be removed on new update.

    voucher_end_date_type stringdeprecated

    Possible values: [offset, date]

    ignore will be removed on new update.

    voucher_end_date_value ISO 8601deprecated

    ignore will be removed on new update.

    products

    object[]

  • Array [

  • guid uuid

    The guid of the Product.

    finn_original_price integer

    The original price, i.e. the price of the Product.

    finn_value integer

    The value of the Product used when deriving the service fees. This is the price that is paid for the Product. Only used for optional Products.

    finn_inner_value integer

    The actual value of the Product, i.e.

    • If the Ticket Type of the Ticket has a min price, then this is the original price of the Ticket divided by the number of force products;
    • Otherwise, this is the original price of the Product.
    In all cases, the discount applied to the Product is subtracted.

    finn_service_fee integer

    The service fees of the Product.

    finn_price integer

    The total price of the Product. This is the sum of the value, inner value, and service fees.

    is_optional boolean

    Whether this Product is an optional Product.

    is_complete boolean

    Whether the Order is complete, i.e. whether all required OrderMetaData is filled in.

    coupon_code string

    The code of the CouponCode this Product belongs to.

    coupon_code_id uuid

    The guid of the CouponCode this Product belongs to.

    price integerdeprecated

    Replaced by the finn values.

    vat float

    The VAT percentage which applies to this Product. This is a float with at most 2 decimals, because VAT percentages in some countries have fractions of a percent.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    invalidated_since ISO 8601

    The date at which this was invalidated.

    invalidated_reason string

    The reason why this was invalidated.

    created_at_int integer

    The time it was created at as a unix timestamp.

    metaData

    object

    guid uuid

    The guid of the OrderMetadata.

    metadata_id uuid

    The guid of the Metadata this OrderMetadata belongs to.

    order_id uuid

    The guid of the Order this OrderMetadata belongs to.

    value string

    The value of the OrderMetaData.

    is_required boolean

    Whether the OrderMetaData is required to be filled in.

    is_complete boolean

    Whether the OrderMetaData has been filled in.

    metadata

    object

    guid uuidrequired

    The guid of the MetaData.

    name stringrequired

    Possible values: <= 255 characters

    The human readable name for the MetaData.

    shop_description string

    Additional info for the MetaData, i.e. the description of the MetaData.

    type stringrequired

    Possible values: [integer, string, date, enum, enumOther, boolean, values, seatSelect, phone]

    The type of the MetaData is related to UI that needs to be presented. The "seatSelect" type can only be set by an admin.

    extra string

    Possible values: <= 60000 characters

    Extra information which is required for the type, i.e. this is Laravel validation rules.

    copy_on_swap boolean

    When a ticket swap creates a new Ticket Type, whether the value of this MetaData should be copied to the new Ticket Type. If you are unsure, leave this false; incorrect usage could leak personal information.

    auto_fill_facebook string

    Possible values: [none, first_name, last_name, email, gender, date_of_birth, age, city, country]

    The Facebook input type to auto fill the MetaData. This has been disabled by Facebook.

    translate_name string

    The translated name. This property is calculated.

    translatable boolean

    Whether the MetaData is translatable or not.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    created_at_int integer

    The time it was created at as a unix timestamp.

    product

    object

    guid uuidrequired

    The guid of the Product Type.

    event_id uuidrequired

    The guid of the Event associated with the Product Type.

    name stringrequired

    Possible values: <= 255 characters

    The name of the Product Type.

    description string

    Possible values: <= 65536 characters

    The description of the Product Type.

    vat_percentage floatrequired

    Possible values: <= 100

    The VAT percentage which applies to this Product Type. This is a float with at most 2 decimals, because VAT percentages in some countries have fractions of a percent.

    price integer

    The price of this Product Type in cents.

    pricing_method string

    Possible values: [own, container]

    The type of pricing method. Whether the container value or its own value is used for varying kickback calculations.

    class string

    Possible values: [EventProtect, RefundProtect, RandomNumberGenerator, PlayPass, Co2Compensate, Giro555]

    The class which get called on order Events.

    origin_type string

    Possible values: [date, ticket, product]

    The type of Product Type. This is either date, ticket, or product. This is auto-generated.

    status string

    Possible values: [auto, sold_out]

    The sale status of the Product Type.

    extra_data array

    Extra class data.

    eventDates

    object[]

  • Array [

  • guid uuidrequired

    The guid of the EventDate

    event_id uuidrequired

    The guid of the Event for this EventDate.

    start ISO 8601required

    The start of the date range.

    end ISO 8601required

    The end of the date range. Must be later than start date.

    seats_event_key string

    Possible values: <= 255 characters

    The Event key (See Seats.io).

    facebook_event_id string

    Possible values: <= 255 characters

    The Facebook event ID.

    seated boolean

    Whether an EventDate is seated or not.

    event

    object

    guid uuidrequired

    The guid of the Event.

    company_id uuid

    The guid of the Company the Event belongs to.

    location_id uuid

    The guid of the Location the Event belongs to.

    event_refund_setting_id uuid

    The guid of the EventRefundSetting of the Event.

    name stringrequired

    Possible values: <= 255 characters

    The name of the Event.

    description string

    Possible values: <= 65536 characters

    The description of the Event.

    email_info string

    Possible values: <= 1000 characters

    Extra information added to the email sent to ticket buyers.

    type stringrequired

    Possible values: [once, repeating]

    The type of the Event. This is either "repeating" or just "once".

    status stringrequired

    Possible values: [disabled, normal, sold_out, refunding, moving]

    Default value: normal

    The current status of sale or refund of the Event. One can set the status of a Ticket Type here.

    visitor_contact_email email

    Possible values: <= 255 characters

    Contact email for visitors.

    visitor_contact_phone phoneNumber

    Possible values: <= 255 characters

    Contact phone for visitors.

    visitor_contact_url string

    Possible values: <= 255 characters

    Contact url for visitors.

    website url

    Possible values: <= 255 characters

    The website of the Event.

    locale IETF BCP 47required

    The locale of the Event.

    currency ISO 4217required

    The currency of the Event

    category string

    The category of the Event.

    subcategories string[]

    The subcategories of the Event.

    retrievable_after ISO 8601

    The date after which the Ticket Types of this Event may be retrieved.

    auto-prune boolean

    Whether to automatically remove Events from the Shops.

    location

    object

    guid uuidrequired

    The guid of the Location

    company_id uuid

    The guid of the Company of the Location.

    name stringrequired

    Possible values: <= 255 characters

    The name of the Location.

    description string

    Possible values: <= 65535 characters

    The description of the Location.

    capacity integerrequired

    Possible values: <= 9999999999

    The maximum capacity of people that can be at this Location. This number is strictly positive or 0 signaling an infinite capacity.

    latitude float

    Possible values: >= -85 and <= 85

    The latitude in LatLng format.

    longitude float

    Possible values: >= -180 and <= 180

    The longitude in LatLng format.

    address string

    Possible values: <= 65536 characters

    The address of this Location. This is free text, so it can be as large or small as desired.

    public boolean

    Whether this Location should appear in the public listing.

    seats_chart_key string

    The key of the seating chart. See Seats.io for more information.

    parent_guid uuid

    The guid of the parent Location. In the case that the Location has a parent.

    seated boolean

    Whether the Location provides seating or not.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    deleted_at ISO 8601

    The time it was deleted.

    location

    object

    guid uuidrequired

    The guid of the Location

    company_id uuid

    The guid of the Company of the Location.

    name stringrequired

    Possible values: <= 255 characters

    The name of the Location.

    description string

    Possible values: <= 65535 characters

    The description of the Location.

    capacity integerrequired

    Possible values: <= 9999999999

    The maximum capacity of people that can be at this Location. This number is strictly positive or 0 signaling an infinite capacity.

    latitude float

    Possible values: >= -85 and <= 85

    The latitude in LatLng format.

    longitude float

    Possible values: >= -180 and <= 180

    The longitude in LatLng format.

    address string

    Possible values: <= 65536 characters

    The address of this Location. This is free text, so it can be as large or small as desired.

    public boolean

    Whether this Location should appear in the public listing.

    seats_chart_key string

    The key of the seating chart. See Seats.io for more information.

    parent_guid uuid

    The guid of the parent Location. In the case that the Location has a parent.

    seated boolean

    Whether the Location provides seating or not.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    deleted_at ISO 8601

    The time it was deleted.

  • ]

  • returns

    object[]

  • Array [

  • guid uuid

    The guid of the Returned.

    order_id uuid

    The guid of the Order of the Returned.

    returns_type string

    The type of the object this Returned belongs to.

    returns_id uuid

    The guid of the object this Returned belongs to.

    returns_count integer

    This is the count of how many times the object is Returned.

    amount float

    The amount to Refund in cents.

    includes_fees boolean

    Whether to include the service fees in the Refund.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    order

    object

    guid uuid

    The guid of the Order.

    purchase_channel string

    The channel through which the Order is purchased.

    finn_original_price integer

    The original price, i.e. the price of the Order before any CouponCodes have been applied.

    finn_value integer

    The value of the Order used when deriving the service fees. This is the price that is paid for the Order, i.e. the sum of the values of the Tickets of the Order.

    finn_service_fee integer

    The service fees of the Order. This is calculated upon the value.

    finn_price integer

    The total price of the Order. This is the sum of the value, and service fees.

    shop_id uuid

    The guid of the Shop associated with the Order.

    is_seated boolean

    Whether any of the Tickets of the Order is seated.

    email email

    The email address of the Receiver.

    send_email boolean

    Whether to send the PDF to the visitor.

    is_complete boolean

    Whether the Order is complete, i.e. whether all required OrderMetaData is filled in.

    has_receipt boolean

    Whether the Order has a receipt.

    pdf_rendered boolean

    Whether the PDF has been rendered.

    status string

    The status of the Order.

    amount integerdeprecated

    Replaced by the finn values.

    transaction_fee integerdeprecated

    Replaced by the finn values.

    invalidated_since ISO 8601

    The date at which this Order was invalidated.

    invalidated_reason string

    The reason why this Order was invalidated.

    firstName string

    The first name of the Receiver.

    lastName string

    The last name of the Receiver.

    locale IETF BCP 47

    The locale of the Receiver.

    fullname string

    The full name of the Receiver

    download_link url

    The link where the Order can be downloaded.

    download_ready boolean

    Whether the Order can be downloaded.

    receipt_link url

    The link to the receipt of the Order.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    created_at_int integer

    The time it was created at as a unix timestamp.

    techData

    object

    guid uuid

    The guid of the TechData.

    order_id uuid

    The guid of the Order of the TechData.

    user_id uuid

    The guid of the User of the TechData.

    comment string

    A comment on the Order.

    data string

    Technical data associated with the Order in json format.

    decoded string

    The data in a json decoded format.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    created_at_int integer

    The time it was created at as a unix timestamp.

  • ]

  • ]

  • metadata

    object

    guid uuid

    The guid of the OrderMetadata.

    metadata_id uuid

    The guid of the Metadata this OrderMetadata belongs to.

    order_id uuid

    The guid of the Order this OrderMetadata belongs to.

    value string

    The value of the OrderMetaData.

    is_required boolean

    Whether the OrderMetaData is required to be filled in.

    is_complete boolean

    Whether the OrderMetaData has been filled in.

    metadata

    object

    guid uuidrequired

    The guid of the MetaData.

    name stringrequired

    Possible values: <= 255 characters

    The human readable name for the MetaData.

    shop_description string

    Additional info for the MetaData, i.e. the description of the MetaData.

    type stringrequired

    Possible values: [integer, string, date, enum, enumOther, boolean, values, seatSelect, phone]

    The type of the MetaData is related to UI that needs to be presented. The "seatSelect" type can only be set by an admin.

    extra string

    Possible values: <= 60000 characters

    Extra information which is required for the type, i.e. this is Laravel validation rules.

    copy_on_swap boolean

    When a ticket swap creates a new Ticket Type, whether the value of this MetaData should be copied to the new Ticket Type. If you are unsure, leave this false; incorrect usage could leak personal information.

    auto_fill_facebook string

    Possible values: [none, first_name, last_name, email, gender, date_of_birth, age, city, country]

    The Facebook input type to auto fill the MetaData. This has been disabled by Facebook.

    translate_name string

    The translated name. This property is calculated.

    translatable boolean

    Whether the MetaData is translatable or not.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    created_at_int integer

    The time it was created at as a unix timestamp.

    returns

    object[]

  • Array [

  • guid uuid

    The guid of the Returned.

    order_id uuid

    The guid of the Order of the Returned.

    returns_type string

    The type of the object this Returned belongs to.

    returns_id uuid

    The guid of the object this Returned belongs to.

    returns_count integer

    This is the count of how many times the object is Returned.

    amount float

    The amount to Refund in cents.

    includes_fees boolean

    Whether to include the service fees in the Refund.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    order

    object

    guid uuid

    The guid of the Order.

    purchase_channel string

    The channel through which the Order is purchased.

    finn_original_price integer

    The original price, i.e. the price of the Order before any CouponCodes have been applied.

    finn_value integer

    The value of the Order used when deriving the service fees. This is the price that is paid for the Order, i.e. the sum of the values of the Tickets of the Order.

    finn_service_fee integer

    The service fees of the Order. This is calculated upon the value.

    finn_price integer

    The total price of the Order. This is the sum of the value, and service fees.

    shop_id uuid

    The guid of the Shop associated with the Order.

    is_seated boolean

    Whether any of the Tickets of the Order is seated.

    email email

    The email address of the Receiver.

    send_email boolean

    Whether to send the PDF to the visitor.

    is_complete boolean

    Whether the Order is complete, i.e. whether all required OrderMetaData is filled in.

    has_receipt boolean

    Whether the Order has a receipt.

    pdf_rendered boolean

    Whether the PDF has been rendered.

    status string

    The status of the Order.

    amount integerdeprecated

    Replaced by the finn values.

    transaction_fee integerdeprecated

    Replaced by the finn values.

    invalidated_since ISO 8601

    The date at which this Order was invalidated.

    invalidated_reason string

    The reason why this Order was invalidated.

    firstName string

    The first name of the Receiver.

    lastName string

    The last name of the Receiver.

    locale IETF BCP 47

    The locale of the Receiver.

    fullname string

    The full name of the Receiver

    download_link url

    The link where the Order can be downloaded.

    download_ready boolean

    Whether the Order can be downloaded.

    receipt_link url

    The link to the receipt of the Order.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    created_at_int integer

    The time it was created at as a unix timestamp.

    techData

    object

    guid uuid

    The guid of the TechData.

    order_id uuid

    The guid of the Order of the TechData.

    user_id uuid

    The guid of the User of the TechData.

    comment string

    A comment on the Order.

    data string

    Technical data associated with the Order in json format.

    decoded string

    The data in a json decoded format.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    created_at_int integer

    The time it was created at as a unix timestamp.

  • ]

  • ]

  • products

    object[]

  • Array [

  • guid uuid

    The guid of the Product.

    finn_original_price integer

    The original price, i.e. the price of the Product.

    finn_value integer

    The value of the Product used when deriving the service fees. This is the price that is paid for the Product. Only used for optional Products.

    finn_inner_value integer

    The actual value of the Product, i.e.

    • If the Ticket Type of the Ticket has a min price, then this is the original price of the Ticket divided by the number of force products;
    • Otherwise, this is the original price of the Product.
    In all cases, the discount applied to the Product is subtracted.

    finn_service_fee integer

    The service fees of the Product.

    finn_price integer

    The total price of the Product. This is the sum of the value, inner value, and service fees.

    is_optional boolean

    Whether this Product is an optional Product.

    is_complete boolean

    Whether the Order is complete, i.e. whether all required OrderMetaData is filled in.

    coupon_code string

    The code of the CouponCode this Product belongs to.

    coupon_code_id uuid

    The guid of the CouponCode this Product belongs to.

    price integerdeprecated

    Replaced by the finn values.

    vat float

    The VAT percentage which applies to this Product. This is a float with at most 2 decimals, because VAT percentages in some countries have fractions of a percent.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    invalidated_since ISO 8601

    The date at which this was invalidated.

    invalidated_reason string

    The reason why this was invalidated.

    created_at_int integer

    The time it was created at as a unix timestamp.

    product

    object

    guid uuidrequired

    The guid of the Product Type.

    event_id uuidrequired

    The guid of the Event associated with the Product Type.

    name stringrequired

    Possible values: <= 255 characters

    The name of the Product Type.

    description string

    Possible values: <= 65536 characters

    The description of the Product Type.

    vat_percentage floatrequired

    Possible values: <= 100

    The VAT percentage which applies to this Product Type. This is a float with at most 2 decimals, because VAT percentages in some countries have fractions of a percent.

    price integer

    The price of this Product Type in cents.

    pricing_method string

    Possible values: [own, container]

    The type of pricing method. Whether the container value or its own value is used for varying kickback calculations.

    class string

    Possible values: [EventProtect, RefundProtect, RandomNumberGenerator, PlayPass, Co2Compensate, Giro555]

    The class which get called on order Events.

    origin_type string

    Possible values: [date, ticket, product]

    The type of Product Type. This is either date, ticket, or product. This is auto-generated.

    status string

    Possible values: [auto, sold_out]

    The sale status of the Product Type.

    extra_data array

    Extra class data.

    returns

    object[]

  • Array [

  • guid uuid

    The guid of the Returned.

    order_id uuid

    The guid of the Order of the Returned.

    returns_type string

    The type of the object this Returned belongs to.

    returns_id uuid

    The guid of the object this Returned belongs to.

    returns_count integer

    This is the count of how many times the object is Returned.

    amount float

    The amount to Refund in cents.

    includes_fees boolean

    Whether to include the service fees in the Refund.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    order

    object

    guid uuid

    The guid of the Order.

    purchase_channel string

    The channel through which the Order is purchased.

    finn_original_price integer

    The original price, i.e. the price of the Order before any CouponCodes have been applied.

    finn_value integer

    The value of the Order used when deriving the service fees. This is the price that is paid for the Order, i.e. the sum of the values of the Tickets of the Order.

    finn_service_fee integer

    The service fees of the Order. This is calculated upon the value.

    finn_price integer

    The total price of the Order. This is the sum of the value, and service fees.

    shop_id uuid

    The guid of the Shop associated with the Order.

    is_seated boolean

    Whether any of the Tickets of the Order is seated.

    email email

    The email address of the Receiver.

    send_email boolean

    Whether to send the PDF to the visitor.

    is_complete boolean

    Whether the Order is complete, i.e. whether all required OrderMetaData is filled in.

    has_receipt boolean

    Whether the Order has a receipt.

    pdf_rendered boolean

    Whether the PDF has been rendered.

    status string

    The status of the Order.

    amount integerdeprecated

    Replaced by the finn values.

    transaction_fee integerdeprecated

    Replaced by the finn values.

    invalidated_since ISO 8601

    The date at which this Order was invalidated.

    invalidated_reason string

    The reason why this Order was invalidated.

    firstName string

    The first name of the Receiver.

    lastName string

    The last name of the Receiver.

    locale IETF BCP 47

    The locale of the Receiver.

    fullname string

    The full name of the Receiver

    download_link url

    The link where the Order can be downloaded.

    download_ready boolean

    Whether the Order can be downloaded.

    receipt_link url

    The link to the receipt of the Order.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    created_at_int integer

    The time it was created at as a unix timestamp.

    techData

    object

    guid uuid

    The guid of the TechData.

    order_id uuid

    The guid of the Order of the TechData.

    user_id uuid

    The guid of the User of the TechData.

    comment string

    A comment on the Order.

    data string

    Technical data associated with the Order in json format.

    decoded string

    The data in a json decoded format.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    created_at_int integer

    The time it was created at as a unix timestamp.

  • ]

  • ]

  • payments

    object[]

  • Array [

  • guid uuid

    The guid of the Payment.

    finn_value integer

    The monetary value of the Payment in cents.

    finn_service_fee integer

    The service fees of the Payment in cents.

    finn_price integer

    The total price of the Payment, this is finn_value + finn_service_fee.

    status string

    The current status of the Payment.

    payment_method_id uuidrequired

    The guid of the PaymentMethod used to execute the Payment.

    payment_id uuid

    The id of the payment (transaction) provided by the external Payment Provider.

    amount integer

    The amount of money (to be) paid in cents.

    currency ISO 4217required

    The currency in which the Payment will be paid.

    description string

    A description of the Payment.

    statii

    object[]

    A list of all the statii that the Payment has had.

  • Array [

  • status stringrequired

    The status of the Payment.

    reason string

    Possible values: <= 255 characters

    The reason for the status.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    created_at_int integer

    The time it was created at as a unix timestamp.

  • ]

  • created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    paymentMethod

    object

    guid uuidrequired

    The guid of the PaymentMethod.

    name stringrequired

    Possible values: <= 255 characters

    The name of the PaymentMethod.

    returns

    object[]

  • Array [

  • guid uuid

    The guid of the Returned.

    order_id uuid

    The guid of the Order of the Returned.

    returns_type string

    The type of the object this Returned belongs to.

    returns_id uuid

    The guid of the object this Returned belongs to.

    returns_count integer

    This is the count of how many times the object is Returned.

    amount float

    The amount to Refund in cents.

    includes_fees boolean

    Whether to include the service fees in the Refund.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    order

    object

    guid uuid

    The guid of the Order.

    purchase_channel string

    The channel through which the Order is purchased.

    finn_original_price integer

    The original price, i.e. the price of the Order before any CouponCodes have been applied.

    finn_value integer

    The value of the Order used when deriving the service fees. This is the price that is paid for the Order, i.e. the sum of the values of the Tickets of the Order.

    finn_service_fee integer

    The service fees of the Order. This is calculated upon the value.

    finn_price integer

    The total price of the Order. This is the sum of the value, and service fees.

    shop_id uuid

    The guid of the Shop associated with the Order.

    is_seated boolean

    Whether any of the Tickets of the Order is seated.

    email email

    The email address of the Receiver.

    send_email boolean

    Whether to send the PDF to the visitor.

    is_complete boolean

    Whether the Order is complete, i.e. whether all required OrderMetaData is filled in.

    has_receipt boolean

    Whether the Order has a receipt.

    pdf_rendered boolean

    Whether the PDF has been rendered.

    status string

    The status of the Order.

    amount integerdeprecated

    Replaced by the finn values.

    transaction_fee integerdeprecated

    Replaced by the finn values.

    invalidated_since ISO 8601

    The date at which this Order was invalidated.

    invalidated_reason string

    The reason why this Order was invalidated.

    firstName string

    The first name of the Receiver.

    lastName string

    The last name of the Receiver.

    locale IETF BCP 47

    The locale of the Receiver.

    fullname string

    The full name of the Receiver

    download_link url

    The link where the Order can be downloaded.

    download_ready boolean

    Whether the Order can be downloaded.

    receipt_link url

    The link to the receipt of the Order.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    created_at_int integer

    The time it was created at as a unix timestamp.

    techData

    object

    guid uuid

    The guid of the TechData.

    order_id uuid

    The guid of the Order of the TechData.

    user_id uuid

    The guid of the User of the TechData.

    comment string

    A comment on the Order.

    data string

    Technical data associated with the Order in json format.

    decoded string

    The data in a json decoded format.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    created_at_int integer

    The time it was created at as a unix timestamp.

  • ]

  • ]

  • refunds

    object[]

  • Array [

  • guid uuidrequired

    The guid of the Refund.

    original_order_id uuid

    The guid of the Order that is being refunded. (A new Order is created to be able to refund, see order_id)

    order_id uuid

    The guid of the Order this Refund belongs to.

    original_payment_id uuid

    The payment of the original Order (see original_order_id). This is what is paid originally and will be (partly) refunded by the new payment (see payment_id).

    payment_id uuidrequired

    The guid of the Payment this Refund belongs to.

    payment_method_id uuidrequired

    The guid of the PaymentMethod this Refund belongs to.

    type stringrequired

    Possible values: [payment, payout]

    The type of the Refund.

    amount float

    The amount (to be) refunded in cents.

    currency ISO 4217

    The currency in which the Refund will be paid.

    status string

    The current status of the Refund.

    description string

    The description of the Refund.

    refund_transaction_id string

    The id of the transaction provided by the external Payment Provider.

    refund_error string

    This contains the error, if the Refund could not execute due to an error.

    executed_at integer

    The unix timestamp at which the Refund was executed.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

    method

    object

    guid uuidrequired

    The guid of the PaymentMethod.

    name stringrequired

    Possible values: <= 255 characters

    The name of the PaymentMethod.

    payouts

    object[]

  • Array [

  • guid uuidrequired

    The guid of the Payout.

    payable_id uuid

    The identifier of the object which will be paid.

    payable_type string

    Possible values: [App\Models\Finance\Clearing, App\Models\Payment\Refund]

    The type of the object that will be paid.

    currency ISO 4217

    The currency in which the Payout will be paid.

    amount integerrequired

    The amount of money (to be) paid out in cents.

    blocked boolean

    Whether this Payout is blocked, blocked Payouts will not be processed.

    account_number stringrequired

    The (bank) account number to which this will be paid.

    bic stringrequired

    The BIC of the financial institution of the account number.

    name stringrequired

    The name of the owner of the bank account.

    description string

    A description of the Payout, commonly contains the internal and company references.

    transaction_id string

    The identifier of the transaction provided by the external Payout Provider.

    failed_reason string

    Contains the reason why a Payout has failed, if the Payout failed, null otherwise.

    executed_at integer

    The unix timestamp at which the Payout was executed.

    status string

    Possible values: [success, ready, blocked, failed]

    The status of this Payout.

    created_at ISO 8601

    The time it was created.

    updated_at ISO 8601

    The time it was last updated.

  • ]

  • ]

Loading...