Skip to content

Initiating a transfer

Request

Initiate a transfer of one or more tickets from the requesting user to another TickeTing user. Initiating a transfer, does not automatically move tickets between accounts, but instead sends a transfer request. This request must first be claimed at which time the tickets themselves are transferred. If the transfer request is cancelled or rejected, no tickets change hands.

One or more tickets, for one or multiple events, can be sent in a single transfer. Tickets that are part of an open transfer (not yet claimed, canclled or rejected) enter into a pending state in which they cannot be redeemed, only becoming usable again once a decision is taken on the transfer.

Security
SessionKey(Required scopes: customeradministrator)
Bodyapplication/json
senderstring^[A-Z]{2}-[A-Z0-9]{8}$

Unique identifier of the account initiating this transfer

recipientstring

Username or email address of the intended recipient

ticketsobject

Sections for which to transfer tickets. The object's keys are the URI of the event section of the tickets being transferred, while its values are the number of tickets to transfer for that section.

curl -i -X POST \
  https://docs.ticketingevents.com/_mock/openapi/transfers \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "sender": "MO-6A39EE8D",
    "recipient": "billy.butcher",
    "tickets": {
      "/events/16993717817996/sections/16993964783416": 2
    }
  }'

Responses

The transfer was successfully initiated.

Bodyapplication/json
selfstring, (uri)

URI of the transfer resource

statusstring

Current status of the transfer

initiatedstring, (date-time)

The date and time at which the transfer was initiated

senderobject(account)
recipientobject(account)
ticketsArray of objects

List of tickets involved in the transfer

Response
{
  "self": "/transfers/17096551195817",
  "status": "Pending",
  "tickets": [
    { … }
  ],
  "initiated": "2025-11-13T12:16:57+00:00",
  "sender": {
    "self": "/accounts/MO-6A39EE8D",
    "number": "MO-6A39EE8D",
    "username": "mothers.milk",
    "email": "marvin.milk@usmc.gov",
    "firstName": "Marvin",
    "lastName": "Milk"
  },
  "recipient": {
    "self": "/accounts/BI-5A939D5D",
    "number": "BI-5A939D5D",
    "username": "the_butcher",
    "email": "elcapitaine@yahoo.com",
    "firstName": "Billy",
    "lastName": "Butcher"
  },
  "claims": "/transfers/17096551195817/claims"
}