---
title: "GET /api/tickets/batch/{batchId}"
method: GET
path: "/api/tickets/batch/{batchId}"
tags: ["api", "tickets"]
---

# GET /api/tickets/batch/{batchId}

`GET /api/tickets/batch/{batchId}`

Get Tickets of Batch

## Path parameters

- `batchId` string, required

## Query parameters

- `sellerId` union, required
  - string
  - string

## Response `200`

OK

- TicketResource[]
  - `_id` string, required
  - `sellerId` string, required — The ID of the seller that ticket belongs to.
  - `company` string
  - `email` string
  - `name` string — The name of the ticket owner
  - `firstname` string — The first name of the ticket owner
  - `lastname` string — The last name of the ticket owner
  - `street` string
  - `line2` string — The additional address field of the user of the ticket
  - `city` string
  - `postal` string
  - `state` string — The state of the user of the ticket
  - `country` string — The country of the user of the ticket
  - `eventId` string, required — The ID of the event the ticket belongs to
  - `rootEventId` string — The ID of the root event, if exists
  - `transactionId` string — The transaction the ticket originated from
  - `posId` string — The point of sale the ticket was created on
  - `underShopId` string — The ID of an undershop the ticket was purchased through
  - `categoryRef` string — A UUID of the category the ticket belongs to.
  - `categoryName` string — The name of the category the ticket belongs to.
  - `ticketTypeId` string, required — The ID of the ticket type this ticket inherits from
  - `slotId` string — The ID of the time slot this ticket belongs to, if exists
  - `slotStartTime` string — The start time of the time slot this ticket belongs to, if exists.
  - `cartItemId` string — The ID of the cart item to which the ticket belongs
  - `triggeredBy` string[] — An array of IDs of cart items which triggered the buy action of the ticket
  - `ticketName` string, required — The name of the ticket type this ticket inherits from
  - `currency` 'EUR' | 'USD' | 'GBP' | 'AUD' | 'CHF' | 'THB' | 'ILS' | 'COP' | 'MXN' | 'DKK' | 'NOK' | 'SEK' | 'QAR' | 'CAD' | 'ISK' | 'GTQ' | 'INR' | 'DOP' | 'SGD' | 'PLN' | 'SAR' | 'TTD' | 'ZAR' | 'KYD' | 'HKD' | 'CZK' | 'KRW' | 'JPY' | 'NZD' | 'AED' | 'MAD' | 'TWD' | 'BRL' | 'BWP' | 'NAD' | 'KES' | 'SCR' | 'TRY' | 'SZL' | 'LSL' | 'TZS' | 'UGX' | 'ZMW' | 'ZWG' | 'GHS' | 'NGN' | 'SLE' | 'LRD' | 'XOF' | 'XAF' | 'GEL' | 'IDR' | 'ARS' | 'CRC' | 'HUF' | 'EGP' | 'MYR' | 'VND' | 'PHP' | 'MWK' — An ISO 4217 3-character code of the currency
  - `regularPrice` number, float — The original non discounted price for the ticket
  - `realPrice` number, float — The real price for the ticket
  - `completed` boolean — Whether all steps for validating the ticket has been made
  - `createdAt` string, date-time, required — An ISO Timestamp indicating when the ticket was created.
  - `updatedAt` string, date-time, required — An ISO Timestamp indicating when the ticket was updated.
  - `expiresAt` string, date-time — An ISO Timestamp indicating when the ticket will be expired.
  - `status` 'VALID' | 'INVALID' | 'RESERVED' | 'DETAILSREQUIRED' | 'BLANK', required — The status of the ticket
  - `secret` string, required — The secret token of the ticket
  - `barcode` string, required — The barcode of the ticket
  - `seat` string
  - `seatingInfo` object — The associated seating object.
    - `_id` string — The ID of the seating object.
    - `_type` 6 | 7, float, required — Indicates the type of seating object. Seat = 6, General Admission = 7.
    - `categoryId` string — The ID of the category containing the seating object.
    - `statusId` string, required — The ID of a container holding information about the seating status of the seating object.
    - `name` string, nullable — If _type == 7. The name of the general admission.
    - `seatType` 'handicapped' | 'limitedView' | 'foldable', nullable — If _type == 6. The type of the seat. null = normal.
    - `sectionName` string, nullable — If _type == 6. The name of the section where the seat is located.
    - `groupName` string, nullable — If _type == 6. The name of the row group where the seat is located.
    - `rowName` string, nullable — If _type == 6. The name of the row where the seat is located.
    - `seatName` string, nullable — If _type == 6. The seat name.
    - `gate` string, nullable — The entry gate associated with the seating object.
  - `type` 'SINGLE' | 'MULTI' — The type of the ticket
  - `origin` 'yourticket' | 'pos' | 'rebooking' | 'upgrade' | 'subscription' | 'transfer'
  - `extraFields` object — A hashmap of extra fields for the ticket
  - `batch` string — A UUId indicating in which batch the tickets were created
  - `batchCounter` number, float — A counter indicating the order of the ticket in the batch
  - `deliveryType` 'HARD' | 'VIRTUAL' — The delivery type of the ticket
  - `readyForDelivery` boolean — Whether the ticket is ready for delivery
  - `customMessage` string
  - `priceCategoryId` string
  - `entryPermissions` union[]
    - union
      - boolean
      - number
      - object
      - string
  - `customerId` string
  - `history` union[]
    - union
      - boolean
      - number
      - object
      - string
  - `personalized` boolean
  - `excludedEventIds` string[] — An array of IDs of events for which the ticket has been blocked
  - `originTicketId` string — The ID of the origin ticket from which the ticket created
  - `fulfillmentTypeId` string — The ID of the fulfillment type used to deliver the ticket
  - `packageInfo` object — The package information of the ticket
    - `packageId` string, required — The ID of the package
    - `packageConfigId` string, required — The ID of the package configuration
    - `name` string, required — The name of the package
  - `__v` integer
  - `_locks` object[] — List of locks on this ticket
    - `by` string, required
    - `at` string, date-time, required
    - `eventId` string
    - `type` union
      - boolean
      - number
      - object
      - 'resell'
  - `addOns` object[] — A list of Add-Ons of the ticket.
    - `productId` string, required
    - `productVariantId` string, required
    - `name` string, required
  - `capabilities` union[], nullable — The capabilities of the ticket.
    - union
      - object
        - `type` 'self_service_return', required
        - `settings` object, required
          - `returnRelatedItems` boolean
          - `phases` object[], required
            - `condition` object, required
              - …
            - `refundPercentage` number, float, required
      - object
        - `type` 'repersonalization', required
        - `settings` object, required
          - `inherit` boolean
          - `repersonalizationDeadline` object, required
            - `target` string, nullable — The target of the relative date
            - `unit` 'hours' | 'days' | 'weeks' | 'months' | 'years', required — The unit in which the offset is specified
            - `offset` integer, required — The offset to the date
          - `repersonalizationsLimit` number, float, nullable
          - `repersonalizationFee` number, float, nullable
          - `limitOnlyNameChanges` boolean
  - `personalizations` union[] — A list of personalizations of the ticket.
    - union
      - boolean
      - number
      - object
      - string

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/vivenu/apis/vivenu-api.md) · [All operations](https://skmtc.net/vivenu/apis/vivenu-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vivenu/vivenu-api/revisions/36be0dca14e7/schema)
