---
title: "GET /api/tickets"
method: GET
path: "/api/tickets"
tags: ["api", "tickets"]
---

# GET /api/tickets

`GET /api/tickets`

Get all Tickets

## Query parameters

- `name` string — Filter tickets by ticket holder name
- `barcode` string — Filter tickets by barcode
- `start` string, date-time — An ISO timestamp to filter tickets created on or after this date
- `end` string, date-time — An ISO timestamp to filter tickets created on or before this date
- `status` string — Filter by a comma(,) separated list of statuses
- `type` 'SINGLE' | 'MULTI' — Filter tickets by type
- `deliveryType` string — Filter by a comma(,) separated list of deliverTypes
- `event` string — Filter by a comma(,) separated list of event IDs
- `statusId` string — Filter tickets with a seat by status ID
- `gaName` string — Filter tickets with a seat by general admission name
- `sectionName` string — Filter tickets with a seat by section name
- `groupName` string — Filter tickets with a seat by group name
- `rowName` string — Filter tickets with a seat by row name
- `seatName` string — Filter tickets by seat name
- `customerId` string — Filter tickets by customer ID
- `purchaseIntentId` string — Filter tickets by purchase intent ID
- `checkoutId` string — Filter tickets by the ID of the checkout
- `subscriptionId` string — Filter tickets by the ID of the subscription
- `updatedAt` object — Range of dates indicating when the ticket was last updated in ISO format.
  - `$gt` string, date-time — value is greater than
  - `$gte` string, date-time — value is greater than or equal
  - `$lt` string, date-time — value is less than
  - `$lte` string, date-time — value is less than or equal
  - `$eq` string, date-time — value is equal
  - `$ne` string, date-time — value is not equal
- `batch` string — Filter tickets by batch
- `batchCounter` object — Filter tickets by batch counter
  - `$gt` number, float — value is greater than
  - `$gte` number, float — value is greater than or equal
  - `$lt` number, float — value is less than
  - `$lte` number, float — value is less than or equal
  - `$eq` number, float — value is equal
  - `$ne` number, float — value is not equal
- `packageId` string — Filter tickets by package ID
- `top` integer — A limit on the number of objects to be returned. Can range between 1 and 1000.
- `skip` integer — The number of objects to skip for the requested result

## Response `200`

OK

- GETTicketsGetAllTickets200Response
  - `rows` 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
              - …
        - object
          - `type` 'repersonalization', required
          - `settings` object, required
            - `inherit` boolean
            - `repersonalizationDeadline` object, required
              - …
            - `repersonalizationsLimit` number, float, nullable
            - `repersonalizationFee` number, float, nullable
            - `limitOnlyNameChanges` boolean
    - `personalizations` union[] — A list of personalizations of the ticket.
      - union
        - boolean
        - number
        - object
        - string
  - `total` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[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)
