# Retrieve a shipment

Only available to Buyer Users.

Endpoint: GET /me/shipments/{shipmentID}
Version: 1.0.445.36017
Security: OAuth2

## Path parameters:

  - `shipmentID` (string, required)
    ID of the shipment.

## Response 200 fields (application/json):

  - `ID` (string)

  - `BuyerID` (string)

  - `Shipper` (string)
    For reference only, does not influence any OrderCloud behavior.

  - `DateShipped` (string)
    In order to properly trigger OrderShipped emails, this date must be NULL on initial create. Update with the date only when all of the Shipment items have been created. Once all of an order's items exist on a shipment that has a DateShipped populated the OrderShipped message sender will trigger and Order.Status will be updated to Complete.
    Example: "2018-01-01T00:00:00-06:00"

  - `DateDelivered` (string)
    Example: "2018-01-01T00:00:00-06:00"

  - `TrackingNumber` (string)

  - `Cost` (number)
    For reference only, does not influence any OrderCloud behavior.

  - `OwnerID` (string)
    ID of the organization that owns the shipment. Only the marketplace owner can override the OwnerID on create.

  - `xp` (object)
    Example: {}

  - `Account` (string)

  - `FromAddressID` (string)
    Marketplace owner or supplier AddressID where the product will be shipped from.

  - `ToAddressID` (string)

  - `FromAddress` (object)
    Example: {"ID":"","DateCreated":"2018-01-01T00:00:00-06:00","CompanyName":"","FirstName":"","LastName":"","Street1":"","Street2":"","City":"","State":"","Zip":"","Country":"","Phone":"","AddressName":"","xp":{}}

  - `FromAddress.ID` (string)

  - `FromAddress.DateCreated` (string)
    Example: "2018-01-01T00:00:00-06:00"

  - `FromAddress.CompanyName` (string)

  - `FromAddress.FirstName` (string)

  - `FromAddress.LastName` (string)

  - `FromAddress.Street1` (string)

  - `FromAddress.Street2` (string)

  - `FromAddress.City` (string)

  - `FromAddress.State` (string)

  - `FromAddress.Zip` (string)

  - `FromAddress.Country` (string)

  - `FromAddress.Phone` (string)

  - `FromAddress.AddressName` (string)

  - `FromAddress.xp` (object)
    Example: {}

  - `ToAddress` (object)
    Example: {"ID":"","DateCreated":"2018-01-01T00:00:00-06:00","CompanyName":"","FirstName":"","LastName":"","Street1":"","Street2":"","City":"","State":"","Zip":"","Country":"","Phone":"","AddressName":"","xp":{}}

  - `ToAddress.ID` (string)

  - `ToAddress.DateCreated` (string)
    Example: "2018-01-01T00:00:00-06:00"

  - `ToAddress.CompanyName` (string)

  - `ToAddress.FirstName` (string)

  - `ToAddress.LastName` (string)

  - `ToAddress.Street1` (string)

  - `ToAddress.Street2` (string)

  - `ToAddress.City` (string)

  - `ToAddress.State` (string)

  - `ToAddress.Zip` (string)

  - `ToAddress.Country` (string)

  - `ToAddress.Phone` (string)

  - `ToAddress.AddressName` (string)

  - `ToAddress.xp` (object)
    Example: {}

## Response 4XX fields (application/json):

  - `StatusCode` (integer)
    Example: "404"

  - `ErrorCode` (string)
    Example: "NotFoundError"

  - `Message` (string)
    Example: "Object not found"

  - `Data` (object)
    Example: {"ObjectType":"","ObjectID":""}