Skip to main content

Shipments (2.0)

Download OpenAPI specification:Download

All inbound and outbound shipments must be scheduled 24 hours in advance. Deliveries during non-standard business hours (after hours or weekend deliveries) require prior approval and will be billed to your account as an Equinix Smart Hands charge. You must communicate in writing any special shipping or packing instructions and if special packaging material is required. If your shipments are international, Equinix recommends that you hire a U.S. Customs Broker before shipping your equipment to and from our facilities. It is your responsibility to arrange for delivery to and from our facilities and customs clearance at the port of entry.

Shipments

shipments

Schedule inbound or outbound shipment

This method schedules an inbound or outbound shipment for a user with shipments ordering permission.

Authorizations:
BearerAuth
Request Body schema: application/json
type
required
string
Enum: "INBOUND" "OUTBOUND"

Type of shipment to be scheduled.

requestedDateTime
required
string <date-time>

Date and time of shipment schedule in UTC timezone in ISO 8601 format.

cageId
required
string

ID of cage where shipment is to be delivered to or retrieve from.

required
InboundShipments (object) or OutboundShipments (object)
One of
carrier
required
string
Enum: "DHL" "FEDEX" "UPS" "OTHER" "CUSTOMER_CARRIER"

The carrier service that will be delivering the shipment.

carrierTrackingNumbers
required
Array of strings[ items <= 100 characters ]

Shipment tracking number. This field is optional when carrier is of CUSTOMER_CARRIER

carrierName
string [ 2 .. 50 ] characters

This field should be used to specify carrier name when carrier is of OTHER

numberOfBoxes
required
number <= 100000

Number of boxes to be received.

cageDelivery
boolean
Default: false

When set to true, shipment will be delivered to cage.

accountNumber
string

Customer account number. This is required if cage is shared.

description
string [ 10 .. 4000 ] characters

Any additional information that the technician may need to complete your request

customerReferenceId
string [ 1 .. 40 ] characters

Customer Reference Number / External Reference Number

object (purchaseOrder)

Purchase order required only when the Account PO Bareing

type
required
string
Enum: "EXEMPTED" "NEW" "EXISTING"

Type of the Purchase Order

number
string

Purchase order number is applicable when type is EXISTING or NEW.

amount
number

The purchase order amount. This is only applicable when type is NEW

startDate
string <date>

The start date for which the purchase order is valid for. This is only applicable when type is NEW

endDate
string <date>

The end date for which the purchase order is valid for. This is only applicable when type is NEW.

attachmentId
string = 36 characters

Attachment ID of Purchase Order document.

Array of objects (Attachment) <= 5 items

Additional attachments that is required to facilitate scheduled shipments such as instruction manual or photos. To learn about including attachments in your request, see POST Attachment API.

Array (<= 5 items)
id
string = 36 characters

Identifier of the binary attachment UUID.

name
string [ 5 .. 100 ] characters

Name of the binary attachment.

Array of ContactRequestRegisteredUser (object) or ContactRequestNonRegisteredUser (object)

The ordering user is the default Technical and Notification contacts. If you would like to provide a different Technical contact and/or additional Notification contacts, provide the Techical contact and Notificition contact(s) details. There can only be 1 Technical contact (registered user or not), but there can be more than 1 Notification contacts (registered users).

Array
Any of
registeredUsers
required
Array of strings <= 10 items

Username of a registered user.

availability
string
Default: "ANYTIME"
Enum: "WORK_HOURS" "ANYTIME"

Technical contact's availability to receive calls.

timezone
string (Timezone)
Enum: "Atlantic/Canary" "Europe/Dublin" "Europe/London" "Europe/Lisbon" "Africa/Algiers" "Europe/Berlin" "Europe/Amsterdam" "Europe/Copenhagen" "Europe/Madrid" "Europe/Paris" "Europe/Stockholm" "Europe/Zurich" "Europe/Warsaw" "Africa/Cairo" "Africa/Johannesburg" "Africa/Lagos" "Europe/Sofia" "Africa/Nairobi" "Asia/Jerusalem" "Europe/Istanbul" "Europe/Moscow" "Asia/Riyadh" "Asia/Dubai" "Asia/Kabul" "Asia/Tehran" "Asia/Karachi" "Indian/Maldives" "Asia/Kolkata" "Asia/Kathmandu" "Asia/Omsk" "Asia/Rangoon" "Asia/Jakarta" "Asia/Ho_Chi_Minh" "Asia/Brunei" "Asia/Hong_Kong" "Asia/Kuala_Lumpur" "Asia/Manila" "Asia/Shanghai" "Asia/Singapore" "Asia/Taipei" "Australia/Perth" "Asia/Seoul" "Asia/Tokyo" "Australia/Darwin" "Australia/Brisbane" "Pacific/Guam" "Australia/Adelaide" "Australia/Sydney" "Pacific/Auckland" "Pacific/Chatham" "Indian/Christmas" "America/Scoresbysund" "Atlantic/South_Georgia" "America/Sao_Paulo" "America/Detroit" "America/New_York" "America/Puerto_Rico" "America/Toronto" "America/Bogota" "America/Chicago" "America/Winnipeg" "America/Denver" "America/Edmonton" "America/Mexico_City" "America/Los_Angeles" "America/Vancouver" "America/Phoenix" "America/Anchorage" "America/Halifax" "America/Lima" "America/Monterrey" "Pacific/Gambier" "Pacific/Marquesas" "Pacific/Honolulu" "Pacific/Fiji" "Asia/Muscat" "America/Argentina/Buenos_Aires" "America/Caracas" "Etc/GMT+12" "UTC" "GMT" "America/Santiago" "America/St_Johns" "Asia/Almaty" "Asia/Bangkok" "Asia/Calcutta" "Asia/Magadan" "Asia/Yekaterinburg" "Australia/Eucla" "Australia/Lord_Howe" "Europe/Bratislava" "Europe/Brussels" "Europe/Prague" "Europe/Rome" "Europe/Helsinki" "Pacific/Kiritimati" "Pacific/Midway" "Pacific/Tongatapu" "Australia/Melbourne" "Australia/NSW" "Australia/Queensland" "Australia/South" "Australia/Victoria" "Australia/West" "Australia/Canberra"

List of Equinix supported timezones.

type
required
string
Default: "NOTIFICATION"
Enum: "NOTIFICATION" "TECHNICAL"

Type of contact.

Responses

Response Headers
Location
string
Example: "/orders/1-23232322"

Location on newly shipment request

Request samples

Content type
application/json
Example
{
  • "customerReferenceId": "Customer Reference information free text",
  • "description": "Please provide any additonal details the technician may need to complete your request.",
  • "details": {
    },
  • "attachments": [
    ],
  • "contacts": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Update inbound or outbound shipment

This method modifies an inbound or outbound shipment for a user with shipments ordering permission.

Authorizations:
BearerAuth
path Parameters
orderId
required
string

Identifier of the shipments order

Request Body schema: application/json
required

The Shipment to be updated

Array of objects (ContactRequestRegisteredUser_Update) <= 1 items
Array (<= 1 items)
registeredUsers
required
Array of strings [ 1 .. 10 ] items

Username for the registered user party

type
required
string
Value: "NOTIFICATION"

Type of contact

requestedDateTime
string <date-time>

Date the requested date and time.

InboundShipmentsUpdate (object) or OutboundShipmentsUpdate (object)
One of
carrier
string
Enum: "DHL" "FEDEX" "UPS" "OTHER"

The carrier service that will be delivering the shipment.

carrierTrackingNumbers
Array of strings[ items <= 100 characters ]

Shipment tracking number.

carrierName
string [ 2 .. 50 ] characters

This field should be used to specify carrier name when carrier is of OTHER

numberOfBoxes
number <= 100000

Number of boxes to be received.

cageDelivery
boolean

When set to true, shipment will be delivered to cage.

Responses

Request samples

Content type
application/json
{
  • "contacts": [
    ],
  • "requestedDateTime": "2020-05-22T19:23:51.000Z",
  • "details": {
    }
}

Response samples

Content type
application/json
[
  • {
    }
]