Versions Compared

Old Version 11

changes.mady.by.user Mark Kassal

Saved on

compared with

New Version Current

changes.mady.by.user J Cobb

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Page Properties
labelapi_docs_shipments


Name

Complete

Description

Completion of Shipments

Type

PUT / POST

URL

/v9/shipments/:id/complete


Long Description

Complete a TMMobile, TMMobileLink, or FlashSeats shipment that is in the the pending state state.


Parameters

Info

As of 2018-11-29  you may optionally include a URL to claim the tickets with your TM Mobile complete request. Including the URL will reduce the need for you to be contacted if the recipient does not receive the transfer email from the primary box office.


Name

Description

Value Type

Required

tickets

Used to deliver orders where the fulfillment method is barcode and the seller needs to provide barcodes/ticket_ids, or verification_ids.

array of tickets objects

Required for barcode shipments

tm_mobile_link

The URL at which the recipient can claim the transferred tickets.

string (Must be valid URL)

 

Info

If there are multiple URLs please concatenate them with a , (comma).


string

Required for TMMobileLink shipments.

Optional for TMMobile shipments.

N/A for FlashSeats shipments.

transfer_source

(COMING SOON)


The primary market source / system from which tickets were transferred for the consumer and CS teams knowledge.

string (Must be exact value of our stored transferSource list)Values

One of:

  • AXS

(indicates

  • AXS

  • Resale

)

  • AM

(indicates

  • Ticketmaster Account

  • Manager

)

  • BA

(indicates

  • MLB Ballpark

  • App

)

  • DICE Dice.fm

  • FS

(indicates

  • Flash

  • Seats

)

  • MPV MyProVenue

  • PAC

(indicates Paciolan)
SG (indicates SeatGeek)
SH (indicates StubHub)
TM (indicates Ticketmaster.com)
The parameter is optional but heavily requested to avoid CS issues and clarification needed from sellers.

Examples

RequestResponse/v9/shipments/:id/complete Code Block
languagejs
themeRDark

  • Paciolan

  • RDP Tickets.com

  • SGSeatGeek

  • SH StubHub

  • TM Ticketmaster.com

  • VIV vivenu

Optional but recommended to avoid CS issues and clarification needed from sellers.

tickets Object

Name

Description

Value Type

Required

seat

The specific seat number

integer

Required

barcode

or

primary_ticket_id

or

verification_id

For the supplied seat number the barcode, MLB TicketID, or MLB Verification ID

string

At least one is required.

seller_email

ProVenue account email address in which these tickets are held.

string

If the seller is an Authorized Broker for the MLB team for which these tickets are for then the ProVenue account_email is required.

Examples

Completing A Mobile Transfer Order

Task

Request

Response

Complete a Mobile Transfer order including providing a URL to claim the tickets as well as providing the transfer source so that the buyer knows how the tickets were transferred

Code Block
languagejson
{
  "tm_mobile_link":"https://am.ticketmaster.com/tdgarden/claim?123123lets213232go123rangers1231241",
  "transfer_source":"AM"
}

See Shipments / Show

Completing A Barcode Order

Task

Request

Response

Complete a Barcode delivery order for an MLB Authorized Broker

Code Block
languagejson
{
  "tickets": [
    {
      "seat": 1,
      "barcode": "AAAABBBBCCCCDDDD",
      "seller_email": "abctickets@example.com"
    }, 
   {
      "seat": 1,
      "barcode": "BBBBCCCCDDDDEEEE",
      "seller_email": "abctickets@example.com"
    },
  ]
}

or

Code Block
languagejson
{
  "tickets": [
    {
      "seat": 1,
      "primary_ticket_id": "123456789",
      "seller_email": "abctickets@example.com"
    }, 
   {
      "seat": 1,
      "primary_ticket_id": "123456790",
      "seller_email": "abctickets@example.com"
    },
  ]
}

or

Code Block
languagejson
{
  "tickets": [
    {
      "seat": 1,
      "verification_id": "verificationId=ANGELS-REGULAR-4068-7JWV4X7ZSR2LYYZBIXVXW4HI",
      "seller_email": "abctickets@example.com"
    }, 
   {
      "seat": 1,
      "verification_id": "verificationId=ANGELS-REGULAR-4068-8JXV4X7ZSR2FHJDSHJSKHW4ZJ",
      "seller_email": "abctickets@example.com"
    },
  ]
}

See Shipments / Show