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

# GET /api/ticket-transfers

`GET /api/ticket-transfers`

Get All Ticket Transfers

## Query parameters

- `ticketIds` string[] — Tickets array for which ticket transfers are requested
- `status` string[] — Filter ticket transfers by status
- `sender` object — Filter ticket transfers by recipient details
  - `email` string — Filter ticket transfers by sender email
  - `id` string — Filter ticket transfers by sender id
- `recipient` object — Filter ticket transfers by sender details
  - `email` string — Filter ticket transfers by recipient email
  - `id` string — Filter ticket transfers by recipient id
- `eventId` string — Filter ticket transfers by event id
- `origin` union[] — Filter ticket transfers by origin
  - union
    - boolean
    - number
    - object
    - 'customer' | 'stubhub'
- `updatedAt` object — Range of dates indicating when the ticket transfer 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
- `top` number, float — A limit on the number of objects to be returned. Can range between 1 and 1000.
- `skip` number, float — The number of objects to skip for the requested result

## Response `200`

OK

- GETTicketTransfersGetAllTicketTransfers200Response
  - `docs` TicketTransferResource[]
    - `_id` string, required — The ID of the ticket transfer.
    - `secret` string, required — The secret token of the ticket transfer.
    - `ticketIds` string[], required — The ID of the tickets that ticket transfer belongs to.
    - `eventId` string, required — The ID of the event the ticket transfer belongs to.
    - `groupEventId` string — The ID of the group event the ticket transfer belongs to. Only filled in season card case.
    - `sellerId` string, required — The ID of the seller that ticket transfer belongs to.
    - `status` 'CREATED' | 'REJECTED' | 'TRANSFERRED' | 'EXPIRED', required — The status of the ticket ticket transfer.
    - `origin` 'customer' | 'stubhub', required — The origin of the ticket transfer.
    - `recipient` object
      - `email` string, email, required — The email of the ticket transfer recipient.
      - `phone` string, nullable — The phone number of the ticket transfer recipient.
      - `customerId` string, nullable — The ID of the ticket transfer recipient.
    - `sender` object
      - `email` string, email — The email of the ticket transfer sender.
      - `customerId` string, nullable — The ID of the ticket transfer sender.
      - `firstname` string, nullable — The first name of the ticket transfer sender.
      - `lastname` string, nullable — The last name ticket transfer sender.
    - `outcome` object — The object representing result of the completed ticket transfer
      - `tickets` object[] — The array of objects having transfered and origin tickets.
        - `ticketId` string, required — The ID of the transfered ticket.
        - `originTicketId` string, required — The ID of the origin ticket.
    - `history` object[] — An array of history entry items of the ticket transfer.
      - `_id` string, required — The ID of the ticket transfer history entry.
      - `date` string, date-time, required — The date of the history entry.
      - `userId` string, nullable — The ID of the user of the ticket transfer history entry.
      - `type` 'created' | 'rejected' | 'transferred' | 'expired' — The type of the ticket transfer history entry.
    - `expiresAt` string, date-time, nullable — An ISO Timestamp indicating when the ticket transfer will be expired.
    - `createdAt` string, date-time, required — An ISO Timestamp indicating when the ticket transfer was created.
    - `updatedAt` string, date-time, required — An ISO Timestamp indicating when the ticket transfer was updated.
  - `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)