Fever

Fever Order Items API

These endpoints enable to access order-item data. ## Filtering Options The endpoint supports filtering by: | Parameter | Type | Description | |-----------|------|-------------| | `order_ids` | array[integer] | List of specific order IDs | | `plan_ids` | array[integer] | List of specific plan (event) IDs | | `date_field` | string | Date field to filter on (`CREATED_DATE_UTC`, `UPDATED_DATE_UTC`, or `EVENT_START_DATE_UTC`). `UPDATED_DATE_UTC` filters on when the order **data** last changed (any field of the flattened record, including nested/enrichment fields such as plan name), matching the `updated_date_utc` field in the response — not the order's own update time (`order_updated_date_utc`). | | `date_from` | string | Start date for the selected date field. Format: `YYYY-MM-DD HH:mm` or `YYYY-MM-DD` | | `date_to` | string | End date for the selected date field. Format: `YYYY-MM-DD HH:mm` or `YYYY-MM-DD` | ## Model documentation #### Orders with Order Items The goal of this endpoint is to provide a comprehensive picture about orders with detailed information about their associated order items, including buyers, owners, partners, plans, sessions, and more. 📄 /reports/order-items response entity model | Column Name | Description | Example value | |----------------------------|-------------------------------------------------------------------------------|-------------------------------------------------------------| | `id` | Unique order ID. This code groups all tickets bought in the same transaction. | 12345 | | `parent_order_id` | If the order comes from a reschedule, the original order ID | 11234 | | `buyer` | Order buyer information. | _See `order.buyer` documentation below_ | | `created_date_utc` | UTC date when the order was created. | 2021-01-01T00:00:00Z | | `updated_date_utc` | UTC date when the order **data** was last updated — moves whenever any field of the flattened order record changes (including nested/enrichment fields such as plan name, UTM or ratings). This is the field the `UPDATED_DATE_UTC` filter matches, so filtering by `UPDATED_DATE_UTC` and this value are always consistent. | 2021-01-01T00:00:00Z | | `order_updated_date_utc` | UTC date when the order **itself** was last updated (order-level fields only). Unlike `updated_date_utc`, it does not move when only nested/enrichment data changes. | 2021-01-01T00:00:00Z | | `surcharge` | Surcharge applied to the order. | 0.0 | | `currency` | ISO3 currency of the order monetary fields. | USD | | `purchase_channel` | Purchase channel where the transaction comes from. | web | | `channel` | Channel slug through which this order was placed. Use this field to join with `POST /v1/reports/channels/search` — the `channel` field in both endpoints is the same slug. `null` when no channel is recorded on the order (e.g. box-office or pre-channel data). | partner-channel | | `payment_method` | Payment method used. | credit_card | | `purchase_location_source` | Purchase location information. | _See `order.purchase_location_source` documentation below_ | | `billing_zip_code` | Billing ZIP Code manually fulfilled by the customer. | 28001 | | `utm` | UTM information attributed to the order. | _See `order.utm` documentation below_ | | `partner` | Partner information. | _See `order.partner` documentation below_ | | `business` | Business associated with the order. | _See `order.business` documentation below_ | | `plan` | Plan information. | _See `order.plan` documentation below_ | | `coupon` | Coupon information. | _See `order.coupon` documentation below_ | | `assigned_seats` | List of assigned seats for the order. | _See `order.assigned_seats` documentation below_ | | `order_items` | List of order items associated with this order. | _See `order.order_items` documentation below_ | | `booking_questions` | List of booking questions and answers for the order. | _See `order.booking_questions` documentation below_ | | `order_group_id` | 🚧 **Under Development.** Groups orders from cluster tickets. All orders with the same `order_group_id` belong to the same purchase group (e.g., bundled tickets across multiple venues). | 12345 | | `is_main_group_order` | 🚧 **Under Development.** Flag indicating whether this is the main order in a group. `true` for the primary order, `false` for secondary orders in the same group. | true | | `staff_notes` | List of staff notes attached to the order. Opt-in: only returned when the search request includes `included_fields=staff_notes`; otherwise the field is omitted from the response. | `["Payment Details: Groupon", "change ticket to new day"]` | | `booked_slots` | List of booked slots (assets/rooms reserved by the cart). | _See `order.booked_slots` documentation below_ | | `payment_details` | Card payment details for the order (transaction id, brand and descriptive payment method). Empty/null when the order was not paid by card or no card details are recorded. | _See `order.payment_details` documentation below_ | order.buyer | Column Name | Description | Example value | |------------------------|-----------------------------------------------------------------------------------------------------------------|--------------------------------------------------------| | `id` | Unique ID of the buyer. | 123456 | | `first_name` | First name of the order buyer. | John | | `last_name` | Last name of the order buyer. | Doe | | `email` | Email of the order buyer. | test@example.com | | `date_of_birthday` | Date of birth of the order buyer. | 1990-01-01 | | `marketing_preference` | Indicates whether the user accepted receiving marketing communications from the partner in the checkout screen. | true | | `language` | Language of the order buyer, extracted from the device locale. The format is ISO 639-1 (two letters). | en | | `b2b_end_user` | B2B end-user information. `null` when the buyer is not B2B or no B2B end user is linked to the order. | _See `order.buyer.b2b_end_user` documentation below_ | order.buyer.b2b_end_user | Column Name | Description | Example value | |--------------|-----------------------------------|-------------------| | `id` | Unique ID of the B2B end user. | 789012 | | `email` | Email of the B2B end user. | test@feverup.com | | `first_name` | First name of the B2B end user. | John | | `last_name` | Last name of the B2B end user. | Doe | order.purchase_location_source | Column Name | Description | Example value | |----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|---------------| | `id_geo_name` | Geo name ID from where the purchase was made. This field is inferred so it might not be accurate. More information at https://www.geonames.org/about.html | 123456 | | `city_name` | City from where the purchase was made. This field is inferred so it might not be accurate. | Madrid | | `country_code` | Country code from where the purchase was made. This field is inferred so it might not be accurate. | ES | | `region_code` | Region code from where the purchase was made. This field is inferred so it might not be accurate. | MD | | `postal_code` | Best estimate of user location at time of purchase, combining multiple sources of information. | 28001 | | `quality` | Quality order. | 1.0 | order.utm | Column Name | Description | Example value | |------------------------|---------------------------------------------------------------------------------|---------------| | `utm.source` | Value of the UTM source field where the order comes from based on last click. | google | | `utm.medium` | Value of the UTM medium field where the order comes from based on last click. | cpc | | `utm.campaign` | Value of the UTM campaign field where the order comes from based on last click. | campaign_1234 | | `utm.content` | Value of the UTM content field where the order comes from based on last click. | 692693771262 | | `utm.term` | Value of the UTM term field where the order comes from based on last click. | candlelight | | `utm.referring_domain` | Value of the referring domain where the order comes from. | google.com | order.partner | Column Name | Description | Example value | |-------------|---------------------------|---------------| | `id` | Unique ID of the partner. | 1 | | `name` | Name of the partner. | Partner Name | order.business | Column Name | Description | Example value | |-------------|---------------------------------------------|--------------------------------------| | `id` | Unique ID of the business. | 7c1caabf-85cd-42ac-96db-524b15443a7b | | `name` | Name of the business. | Sample City Tours | | `tax_id` | Tax identification number of the business. | B12345678 | order.plan | Column Name | Description | Example value | |--------------|------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------| | `id` | Unique ID of the plan. | 11 | | `name` | Name of the plan, providing a short description of the event the client will attend. | Plan Name | | `gallery` | List of gallery resources (images / videos) attached to the plan. Opt-in: only returned when the search request includes `included_fields=gallery`; otherwise the field is omitted from the response. | _See `order.plan.gallery` documentation below_ | | `taxonomies` | List of taxonomies attached to the plan. Opt-in: only returned when the search request includes `included_fields=taxonomies`; otherwise the field is omitted from the response. | _See `order.plan.taxonomies` documentation below_ | order.plan.gallery | Column Name | Description | Example value | |-------------|----------------------------------------------------------|-------------------------------------| | `url` | URL of the gallery resource. | https://www.example.com/image.jpg | | `type` | Type of the gallery resource. One of `image` or `video`. | image | order.plan.taxonomies | Column Name | Description | Example value | |-------------|--------------------|-----------------| | `id` | Unique taxonomy ID.| 1234 | | `name` | Taxonomy name. | Taxonomy name | order.coupon | Column Name | Description | Example value | |-------------|------------------------------------------------------------|---------------| | `name` | Name of the coupon. | Coupon Name | | `code` | Code of the coupon. | COUPON_CODE | | `discount` | Discount amount applied by the coupon. | 0.0 | | `kind` | Coupon kind label (e.g. `No Coupons`, partner-defined). | No Coupons | order.assigned_seats | Column Name | Description | Example value | |-----------------------------------|-------------------------------|---------------| | `id` | Seat id. | seat_123 | | `name` | Seat name. | A1 | | `seating_provider` | Seating provider. | provider_name | | `seating_provider_seat_reference` | Seating provider's seat name. | ref_123 | order.booking_questions | Column Name | Description | Example value | |-------------|------------------------------------------------|---------------------------------------------| | `id` | Booking question ID. | f4dd7822-8461-44d6-af47-acdbfd47bf80 | | `question` | The booking question text. | How did you find out about this experience? | | `answers` | List of answers provided by the user. | ["Instagram", "Facebook"] | | `index` | The index of the question in the booking flow. | 1 | order.booked_slots Cart-level array of booked slots. The same array is denormalized across every order in the same cart. | Column Name | Description | Example value | |-------------------|----------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------| | `id` | Unique ID of the booked slot. Matches `order_item.booked_slot_id` for every order item assigned to this slot. | 9876543 | | `timeslot_utc` | UTC start of the timeslot the slot is booked for. | 2026-05-08T09:30:00Z | | `slot_count` | Capacity counter from the cart engine. Useful for debugging only — see `party_size` for the actual people booked. | 12 | | `occupancy_count` | Number of independent parties booked at the asset for this cart. | 1 | | `party_size` | Total people (count of order items) sold for this booked slot. | 4 | | `is_removed` | Whether the slot was removed by the cart engine. | false | | `activity` | Activity that owns the booked asset. | _See `order.booked_slots.activity` documentation below_ | | `asset` | Asset (e.g. room) the slot is booked on. | _See `order.booked_slots.asset` documentation below_ | order.booked_slots.activity | Column Name | Description | Example value | |-------------|----------------|-------------------------| | `id` | Activity ID. | 481 | | `name` | Activity name. | Escape Room Northbridge | order.booked_slots.asset | Column Name | Description | Example value | |----------------------------------------------|------------------------------------------------------------------------------|----------------| | `id` | Asset ID (e.g. an Escape This room). | 3473 | | `name` | Asset name. | NB - Asylum | | `description` | Asset description. | | | `availability_strategy` | Capacity strategy used by the asset (`BY_PARTY_COUNT` or `BY_PEOPLE_COUNT`). | BY_PARTY_COUNT | | `max_party_size` | Maximum number of people allowed in a single party. | 4 | | `min_party_size` | Minimum number of people required to book a party. | 1 | | `max_num_parties` | Maximum number of independent parties the asset can host. | 1 | | `partner_id` | Partner that owns the asset. | 190 | | `asset_type_id` | Asset type ID. | 7 | | `is_manual_assignment_confirmation_required` | Whether the asset requires manual assignment confirmation. | false | order.payment_details Order-level array of card payment details. Empty/null when the order was not paid by card. The same array is denormalized across every order item belonging to the same order. | Column Name | Description | Example value | |------------------|---------------------------------------------------------------------------|---------------| | `id` | Transaction ID issued by the payment processor (Braintree, Stripe, ...). | tx_abc123 | | `card_brand` | Card brand (`visa`, `mastercard`, `amex`, `discover`, ...). | visa | | `payment_method` | Descriptive payment method joined from the order's payment configuration. | Card | order.order_items | Column Name | Description | Example value | |-----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------| | `id` | Unique ID of the order item. | 123456 | | `ticket_id` | Operational identifier of the ticket grouping order items from the same session. Provided for compatibility with transactional use cases (e.g., reschedules and transfers); it is not intended as a core reporting metric. | 334455 | | `booked_slot_id` | ID of the booked slot the order item was assigned to within its cart, when the activity behind the session uniquely resolves to a single booked slot (e.g. Escape This rooms). Matches `order.booked_slots[].id`. NULL when the activity exposes more than one asset and the cart engine spread parties across them; consumers can fall back to substring matching against `booked_slots[].asset.name`. | 9876543 | | `cancellation_date_utc` | Last UTC date when any part of the ticket was cancelled. | 2021-01-01T00:00:00Z | | `cancellation_type` | Type of cancellation. REFUND: means that the ticket has been cancelled due to a refund. RESCHEDULE: means that the ticket has been cancelled due to a reschedule. | REFUND | | `created_date_utc` | UTC date of the ticket creation. | 2021-01-01T00:00:00Z | | `discount` | Discount applied to the ticket. | 10.0 | | `is_invite` | Indicates whether the ticket is an invitation from the partner. | false | | `modified_date_utc` | UTC date of the last modification of the ticket. | 2021-01-01T00:00:00Z | | `purchase_date_utc` | UTC date of the ticket purchase. | 2021-01-01T00:00:00Z | | `event_start_date_utc` | UTC start date of the event associated with this order item. | 2021-01-01T00:00:00Z | | `validated_date_utc` | UTC date when the order item was validated. This validation can be independent of the plan code (bar code), since some order items don't have a plan code but can be validated. | 2021-01-01T00:00:00Z | | `rating_comment` | Comment from the ticket user after attending the event. | Great experience! | | `rating_value` | Rating given by the ticket user after attending the event, ranging from 1 to 5. | 5.0 | | `surcharge` | Surcharge applied to the ticket. | 2.0 | | `status` | If the ticket is active, transferred, or cancelled. ACTIVE: means that the ticket ID can be redeemed or it is redeemed. CANCELLED: means that the ticket ID can't be redeemed since it has been cancelled. TRANSFERRED: means that the ticket ID can't be used since it has been fully transferred to another user. | ACTIVE | | `unitary_price` | Unitary price of the purchased ticket. | 50.0 | | `metadata` | Partner-supplied identifiers for reconciliation against the partner's own system of record. **Opt-in via `included_fields=metadata`.** NULL when the partner did not provide any reporting metadata for the order item. | _See `order_item.metadata` documentation below_ | | `owner` | Order item owner information. | _See `order_item.owner` documentation below_ | | `plan_codes` | Plan code associated with the order item. | _See `order_item.plan_codes` documentation below_ | | `session` | Session information. | _See `order_item.session` documentation below_ | | `pack` | Pack information if the order item belongs to a pack. `null` when the order item does not belong to a pack. | _See `order_item.pack` documentation below_ | order_item.metadata Partner-supplied identifiers attached at the time of purchase, intended to help partners reconcile Fever order items against rows in their own system of record (box-office ticket IDs, internal SKUs, subproduct variants, etc.). Only present when the request opts in via `included_fields=metadata`; NULL when the partner did not provide any reporting metadata for the order item. | Column Name | Description | Example value | |--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------| | `external_id` | Partner-supplied external identifier for the order item, as sent by the partner's integration when the order was placed. | CJ51001B | | `external_subproduct_id` | Partner-supplied external subproduct identifier for the order item, used when a single plan exposes multiple distinguishable subproducts (e.g., adult vs. child ticket variants, add-ons, seating categories). | ADULTO | order_item.owner | Column Name | Description | Example value | |------------------------|-----------------------------------------------------------------------------------------------------------------|------------------| | `id` | Unique ID of the person who owns the ticket. | 123456 | | `first_name` | First name of the owner of the ticket. | John | | `last_name` | Last name of the owner of the ticket. | Doe | | `email` | Email of the owner of the ticket. | test@example.com | | `date_of_birthday` | Date of birth of the owner of the ticket. | 1990-01-01 | | `marketing_preference` | Indicates whether the user accepted receiving marketing communications from the partner in the checkout screen. | true | | `language` | Language of the owner of the ticket, extracted from the device locale. The format is ISO 639-1 (two letters). | en | order_item.plan_codes | Column Name | Description | Example value | |---------------------|----------------------------------------------------------------------------------------------------|----------------------| | `id` | Unique ID of the plan code. A plan code is the unique code needed for redemption to join an event. | 111 | | `cd_barcode` | Barcode code associated to the plan code. | A1B2C3 | | `created_date_utc` | UTC date of the creation of the plan code. | 2021-01-01T00:00:00Z | | `modified_date_utc` | UTC date of the last modification of the plan code. | 2021-01-01T00:00:00Z | | `redeemed_date_utc` | UTC date when the plan code was redeemed. | 2021-01-01T00:00:00Z | | `is_cancelled` | Whether the plan code is cancelled or not. | false | | `is_validated` | Whether the plan code has been validated or not. | true | order_item.session | Column Name | Description | Example value | |------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------| | `id` | Unique ID of the session. A session represents a specific date and ticket type of a plan, and also the product the client purchased. | 123456 | | `name` | Name of the session, providing a short description of the product the client purchased. | Session Name | | `end_date_utc` | UTC end date of the session. | 2021-01-01T00:00:00Z | | `first_purchasable_date_utc` | UTC date of the first purchasable date of the session. | 2021-01-01T00:00:00Z | | `is_addon` | Indicates whether the session is an addon. | false | | `is_wait_list` | Indicates whether the session is actually a waitlist. | false | | `start_date_utc` | UTC start date of the session. | 2021-01-01T00:00:00Z | | `venue` | Venue information. | _See `order_item.session.venue` documentation below_ | order_item.session.venue | Column Name | Description | Example value | |-------------|-------------------------------------------------------------|---------------| | `city` | City of the venue where the session takes place. | Madrid | | `country` | Country of the venue where the session takes place in ISO3. | Spain | | `name` | Name of the venue where the session takes place. | Venue Name | | `timezone` | Timezone of the venue where the session takes place. | Europe/Madrid | order_item.pack Pack information for order items that belong to a pack. `null` when the order item does not belong to a pack. | Column Name | Description | Example value | |----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------| | `id` | Unique identifier of the pack unit. Groups all member order items belonging to the same purchased pack. | 11223 | | `session_id` | Unique catalog session ID for the pack. Matches the `id` returned by `GET /v1/sessions`. Stable across all purchases of the same pack session. Use this instead of `session_name`, which is not unique. `null` when the item does not belong to a pack. | 284360344 | | `session_name` | Pack session label (display name of the pack). Not unique — multiple packs across different plans may share the same label. | Family Pack |

GitHub OpenAPI

Operations 2

POST /reports/order-items/search Request order items report #
GET /reports/order-items/search/{search_id} Get order items report #

Documentation

📖
Documentation
https://developer.feverup.com/en/
📖
APIReference
https://data-reporting-api.prod.feverup.com/v1/redoc
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/fever/refs/heads/main/authentication/fever-authentication.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/fever/refs/heads/main/openapi/fever-order-items-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/fever-order-items-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

fever-order-items-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Fever - Reporting Order Items API
  description: Access detailed event sales data through a reliable REST API.
  contact:
    name: Support
    email: data-support@feverup.com
  version: 1.5.0
  x-logo:
    url: https://res.cloudinary.com/fever/image/upload/ar_16:9,c_mpad,w_425/web/fever-logo-dark.jpg
servers:
- url: /v1
tags:


# --- truncated at 32 KB (68 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/fever/refs/heads/main/openapi/fever-order-items-api-openapi.yml