Versions Compared

Key

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


Page Properties
labelapi_docs_shipments


NameShipments Update
DescriptionUpdate a shipment for an existing order
TypePUT
URL/v9/shipments/:id
Credential TypeAPI|User


...

Name
Description
Type
Required
Prerequisite
mobile_transfer_type

Defines how the ticket will be transferred. Must be one of:

  • FlashSeats: Will be transferred via FlashSeats/AXS
  • TMMobile: Will be transferred via Ticketmaster or any other provider such as SeatGeek
  • TMMobileLink: A URL will be provided with which the buyer can claim the tickets.
stringRequired (for this operation) type must be Eticket


PUT /v9/shipments/1234567Response


Paste code macro
languagejson
{"mobile_transfer_type":"TMMobile"}

OR

Paste code macro
languagejson
{"mobile_transfer_type":"FlashSeats"}

OR

Paste code macro
languagejson
{"tm_mobile_shipment_type":"TMMobileLink"}



Code Block
languagejs
themeMidnight
firstline1
titleResponse
linenumberstrue
{
  "id": 5192586,
  "url": "/shipment/5192586",
  "type": "TMMobile",
  "email_address": {
    "id": 4227710,
    "url": null,
    "address": "michaelstarr@example.com",
    "label": null,
    "updated_at": "2021-05-16T22:15:11Z"
  },
}

(Response has been trimmed for brevity.)

SELLER: Change a Shipment From Tbd to Transfer (TMMobile or TMMobileLink)

Orders that are expected to be transferred begin with a default shipment.type of Tbd after order creation and will remain so until the seller decides on the final shipment method (TMMobile or TMMobileLink). See also: HOW TO: Automate Flash & TM Mobile Transfers

Name
Description
Type
Required
Prerequisite
tm_mobile_shipment_type

Defines how the ticket will be transferred. Must be one of:

  • TMMobile: Will be transferred via Ticketmaster or any other provider such as SeatGeek
  • TMMobileLink: A URL will be provided with which the buyer can claim the tickets.
stringRequired (for this operation) type must be Tbd



PUT /v9/shipments/1234567
Response


Paste code macro
languagejson
{"tm_mobile_shipment_type":"TMMobile"}

OR

Paste code macro
languagejson
{"tm_mobile_shipment_type":"TMMobileLink"}



Code Block
languagejs
themeMidnight
firstline1
titleResponse
linenumberstrue
{
  "id": 5192586,
  "url": "/shipment/5192586",
  "type": "TMMobile",
  "email_address": {
    "id": 4227710,
    "url": null,
    "address": "michaelstarr@example.com",
    "label": null,
    "updated_at": "2021-05-16T22:15:11Z"
  },
}

(Response has been trimmed for brevity.)


SELLER: Provide Local Pickup Information

...

Name
Description
Type
Required
ship_from_name
Contact name of the sellerstringRequired when type is LocalPickup
ship_from_phone_number_attributes
Attributes of a new phone number to create and use as a contact number for the seller. A new Phone Number will be created (see example below).HashRequired when type is LocalPickup
ship_from_address_attributes
Attributes of a new address to create and use for the pickup location. A new Address will be created (see example below).HashRequired when type is LocalPickup
pickup_time_range
The pickup timestringRequired when type is LocalPickup
pickup_instructions
Additional notes on location and any other pickup detailsstringOptional


PUT /v9/shipments/1234567
Response


Paste code macro
languagejson
{
   "ship_from_name":"Michael Starr",
   "ship_from_phone_number_attributes":{
      "label":"Cell",
      "country_code":"+1",
      "number":"2015555555",
      "extension":null
   },
   "ship_from_address_attributes":{
      "name":"Michael Starr",
      "street_address":"333 Washington St",
      "extended_address":"Suite 302",
      "locality":"Jersey City",
      "region":"NJ",
      "postal_code":"07307",
      "country_code":"US"
   },
   "pickup_time_range":"2 Hours before game",
   "pickup_instructions":"Call and I will come downstairs"
}



Code Block
languagejs
themeMidnight
firstline1
titleResponse
linenumberstrue
{
  "id": 5184368,
  "url": "/shipments/5184368",
  "type": "LocalPickup",
  "ship_from_name": "Michael Starr",
  "ship_from_address": {
    "id": 63965284,
    "label": null,
    "name": "Michael Starr",
    "street_address": "333 Washington St",
    "extended_address": "Suite 302",
    "locality": "Jersey City",
    "region": "NJ",
    "postal_code": "07307",
    "country_code": "US"
  },
  "ship_from_phone_number": {
    "id": 25954226,
    "url": "/clients//phone_numbers/25954226",
    "label": "Cell",
    "country_code": "+1",
    "number": "2015555555",
    "extension": "",
    "updated_at": "2021-09-06T15:17:54Z"
  }
  "pickup_time_range": "2 Hours before game",
  "pickup_instructions": "Call and I will come downstairs",
}

(Response has been trimmed for brevity.)

If both parties have already updated the shipment with their Local Pickup details, the shipment will move to a Delivered state and can no longer be updated. 

To make changes you will need to contact support. 



BUYER: Provide Local Pickup Information

...

PUT /v9/shipments/1234567
Response


Paste code macro
languagejson
{
   "ship_to_name":"Ralph Saenz",
   "phone_number_attributes":{
      "label":"iPhone",
      "country_code":"+1",
      "number":"2025555555",
      "extension":null
   },
   "notes":"I will be in a Saints jersey"
}



Code Block
languagejs
themeMidnight
firstline1
titleResponselinenumberstrue
{
  "id": 5184368,
  "url": "/shipments/5184368",
  "type": "LocalPickup",
  "ship_to_name": "Ralph Saenz",
  "phone_number": {
    "label": "iPhone",
    "country_code": "+1",
    "number": "2025555555",
    "extension": null
  },
  "notes": "I will be in a Saints jersey"
}

(Response has been trimmed for brevity.)

If both parties have already updated the shipment with their Local Pickup details, the shipment will move to a Delivered state and can no longer be updated. 

To make changes you will need to contact support. 

...