Shipments

The Shipments resource allows a user to create, update, retrieve, and delete shipments. Only test shipments and shipments without labels can be deleted. Shipments with uncancelled or processed labels cannot be updated. All shipments require address verification on the shipping address. Cancelling a label will refund the cost. Test shipments and shipments without labels are routinely purged from the system.

There are some weight and volumetric constraints for shipments that is dependant on the route. For example, if a Shipment's length + girth is greater than a certain size then the user is charged an additional fee per KG. The length is the measurement of the longest dimension, and girth is the distance around the thickest part (perpendicular to the length). If the Shipment's weight or volume exceeds the limit for a route an error will be returned.

Note: Set the overpack_id to null when unassigning it from an overpack. You won't be allowed to update a labelled shipment beyond that.

Actions

GET /shipments Retrieves a paginated list of shipments
GET /shipments/{id} Retrieves a shipment
POST /shipments Creates a shipment
PUT /shipments/{id} Updates a shipment or removes a shipment from an overpack
PUT /shipments/{id}/process Process (close out) a shipment with final weight and dimensions
DELETE /shipments/{id} Deletes a shipment

Properties

carrier

{"carrier": "DHLeC"}

String|null - This grants clients the ability to select the last mile carrier when creating and updating a shipment. An error is returned if no routes exist given the combination of parameters provided by the client. For example, the chosen carrier might be available for some services, weight ranges, exit points, countries, etc. but not necessarily all at once. Optional. Default: null.
carrier_params 
{
    "carrier_params": {
        "ekp": "2222222222",
        "contract_participation": "01",
        "cig_username": "cig_username",
        "cig_password": "cig_password",
        "tnt_username": "tnt_username",
        "tnt_password": "tnt_password",
        "retoure_username": "retoure_username",
        "retoure_password": "retoure_password",
        "receiver_id": "receiver_id",
        "label_format": "910-300-400",
        "client_id": "client_id",
        "client_secret": "client_secret",
        "pickup_id": "pickup_id",
        "distribution_center": "distribution_center"
    }
}

Object (Optional) - The final mile carrier specific parameters. Supported carriers and parameters can be found on the Carrier Parameters page.
claim_url

{"claim_url": "https://www.xcover.com/en/account/claims/fnol?bookingID=AAA-AAA-AAINS"}

String|null - The claim URL if this shipment is covered by insurance. Default: null. Only available when the shipment is eligible for a claim.
comments 

{
    "comments": [
        "SKU #10292301",
        "Comment line 2"
    ]
}

Array - Comments for the bottom of the label. Max of 3 items. Each item in the array is a String with max length of 80. Not required.
consignee 

{
    "consignee": {
        "name": "Addressee John",
        "phone": "555-456-7890",
        "email": null,
        "id": null,
        "street1": "2959 ANCHOR DR",
        "street2": null,
        "city": "MESQUITE",
        "province": "TX",
        "postal_code": "75150",
        "country": "US"
    }
}

Object (Optional). Details about the consignee / buyer. The system will use the shipping address as the consignee address if one isn't provided. Some countries require a tax / passport ID from the buyer.

name: String(40) - The consignee's name. Required.
phone: String(20) - The consignee's phone number. Conditional.
email: String(64) - The consignee's email address. Conditional.
id: String(20) - The consignee's Tax ID, GSTIN, Passport, ABN, Vendor ID, etc. Conditional.
street1: String(40) - The consignee's street address. Required.
street2: String(40) - Additional space for the consignee's street address such as apartment, condo, or unit number. Optional.
city: String(40) - The consignee's city. Required.
province: String(40) - The consignee's province or state code. Conditional.
postal_code: String(10) - The consignee's postal code. Conditional.
country: String(2) - The consignee's country in ISO 3166-1 alpha-2 format. Required.
consignor 

{
    "consignor": {
        "name": "Generic Company, LLC",
        "phone": "555-123-4567",
        "email": "consignor@test.com",
        "id": null,
        "street1": "1 WORLD WAY",
        "street2": "",
        "city": "SHENZHEN",
        "province": "GUANGDONG",
        "postal_code": "518000",
        "country": "CN"
    }
}

Address and other details for the consignor (sender) which is used for customs clearance. Required.

name: String(40) - The consignor's name. Required.
phone: String(20) - The consignor's phone number. Required.
email: String(64) - The consignor's email address. Conditional. Default: null.
id: String(20) - The consignor's Tax ID, GSTIN, Passport, ABN, Vendor ID, etc. Optional.
street1: String(40) - The consignor's street address. Required.
street2: String(40) - Additional space for the consignor's street address such as apartment, condo, or unit number. Optional.
city: String(40) - The consignor's city. Required.
province: String(40) - The consignor's province or state code. Optional.
postal_code: String(10) - The consignor's postal code. Optional.
country: String(2) - The consignor's country in ISO 3166-1 alpha-2 format. Required.
create_label

{"create_label": true}

Boolean - Whether or not the system should attempt to create a label when creating and updating a shipment. Not required. Default is false.
created

{"created": "2015-05-05 15:43:03"}

String - The date and time the shipment was created. Set by the system.
currency

{"currency": "USD"}

String (Optional) - The ISO 4217 currency code for payment. Useful for paying from a separate account balance other than USD. Costs and fees will be shown in the requested currency. The account will be invoiced separately. Defaults to USD. Options: USD, CAD, AUD, JPY, GBP, EUR
duty

{"duty": 2.33}

Decimal - The total duty owed/paid for this shipment in USD. Applies to DDP shipments. Read only.
entry_point

{"entry_point": "SZXI01"}

String - The drop off location for this shipment. Determines the shipping rates and routing. Required. See Entry Points for a list of codes.
exit_point

{"exit_point": "LAX"}

String - The requested IATA port the shipment should be transported to for last mile delivery. Optional. Default is null. Routing will select the port to use if not provided. If a port is provided but not supported then a "No routes found" error is returned.
errors 

{
    "errors": {
        "code": 1080,
        "http_status": 402,
        "message": "Insufficient funds",
        "status": "error"
    }
}

Object - This property is returned if and only if create_label is true and there was an error attempting to create the label.
from 

{
    "from": {
        "name": "My Company Name",
        "street1": "113 INTL BROADWAY",
        "street2": "",
        "city": "LOS ANGELES",
        "province": "CA",
        "postal_code": "91013",
        "country": "US"
    }
}

This will appear as the return address on labels. Optional. A default return address will be used if one isn't provided in the request.

name: String(40) - Can be a sender's name or company name. Required.
street1: String(40) - The sender's street address. Required.
street2: String(40) - Additional space for the sender's street address. Optional.
city: String(40) - The sender's city. Required.
province: String(40) - The sender's province or state. Conditional.
postal_code: String(10) - The sender's postal code or ZIP Code. Conditional.
country: String(2) - The senders's country in ISO 3166-1 alpha-2 format. Must match to.country. Required.

height

{"height": 5.5}

Decimal - The height of the shipment in cm. Not required. Default is 1.
id

{"id": 1014}

Integer - The ID of the shipment. Set by the system.
ignore_bad_address

{"ignore_bad_address": false}

Boolean - Ignore shipping address verification errors. Setting this to true automatically declines insurance coverage unless the shipping address was valid, in which case the system will change this back to false. BoxC Priority addresses can't be ignored. Default: false.
insurance

{"insurance": false}

Boolean - Adds more insurance to the shipment for a fee based on a percentage of the total value (including shipping cost) of the items. By default shipments include insurance that covers up to $30 in total value even when insurance is false. Insurance is not available for the BoxC Post service and some accounts. Default: false.
insured_value

{"insured_value": 35.95}

Decimal - The total value (USD) of the shipment that can be claimed. Set by the system.
irregular

{"irregular": false}

Boolean - Indicates this shipment was packaged in irregular shaped polybag or soft packaging to assist in calculating the volumetric weight. Not required. Default: false.
is_return

{"is_return": false}

Boolean - Indicates this shipment is a return and will select the correct carrier product if any are available. Optional. Default: false.
label 
{
    "label": {
        "cancelled": false,
        "carrier": "USPS",
        "chargeable_weight": 0.284,
        "cost": 3.56,
        "created": "2015-04-30 18:22:00",
        "delivery_date": "2015-09-15",
        "duty": 0,
        "events": [
            {
                "carrier": "USPS",
                "time": "2015-09-15 12:46:04",
                "city": "New York City",
                "province": "NY",
                "postal_code": "10001",
                "code": 200,
                "description": "DELIVERED"
            },
            {
                "...": "..."
            }
        ],
        "exit_point": "LAX",
        "id": 4248261,
        "insurance_fee": 0,
        "is_ready": true,
        "oversize_fee": 0,
        "processed": true,
        "processed_date": "2015-05-02",
        "processed_weight": 0.284,
        "service": "BoxC Parcel",
        "status": "Delivered",
        "surcharge": 0,
        "tracking_number": "9261299991753900000290"
    }
}
Object - The Label created for this shipment. If multiple labels were created, it will return the uncancelled one. Only present when searching shipments. Tracking events are only provided if a single shipment is returned. Set by the system.
labels 
{
    "labels": [
        {
            "...": "..."
        }
    ]
}
Array - A list of all labels created for this shipment. Only present when requesting a single shipment. See the label property for details about the object. Set by the system.
length

{"length": 12}

Decimal - The length of the shipment in cm. Not required. Default is 15.
line_items 
{
    "line_items": [
        {
            "coo": "CN",
            "currency": "USD",
            "description": "Phone case",
            "dg_code": null,
            "hts_code": null,
            "origin_description": "\u624b\u673a\u5916\u58f3",
            "quantity": 2,
            "url": null,
            "weight": 0.235,
            "value": 9.95
        }
    ]
}
Array (Required) - Contents of the shipment.
  • coo String (Required) - The country of origin or where the product was manufactured in ISO 3166-1 alpha-2 format.
  • currency String (Required) - The 3-letter currency code for the value of this line item.
  • description String (Required) - A concise description of the line item in English. Max length: 64.
  • dg_code String (Conditional) - A code that identifies dangerous goods. Required if shipping lithium batteries, ORM-D, or other dangerous goods. Refer to this page for a list of codes and further information.
  • duty Decimal - The duty owed for this line item in USD. Read only.
  • hts_code String (Conditional) - The Harmonized Tariff System classification number for Customs clearance (read more).
  • origin_description String (Required) - A concise description of the line item in the entry point country's language. Max length: 64.
  • quantity Integer (Required) - The number of units in this line item. Max: 9999.
  • tax Decimal - The tax owed for this line item in USD. Read only.
  • url String - URL to the product listing online. Optional. Max length: 128. Default: null.
  • value Decimal (Required) - The total declared value of all units in this line item.
  • weight Decimal (Required) - The weight for a single unit of this line item.
order_number

{"order_number": "23018721-ABC"}

String|null - This can be used as a searchable reference for this shipment. Zonos customers should place their Order ID here. It does not have to be a unique value. Max length: 40. Default: null.
overpack_id

{"overpack_id": 1291028}

Integer - The overpack this shipment is assigned to. Default is null. Set to null when removing a shipment from an overpack.
service

{"service": "BoxC Priority"}

String - The type of shipping service you want to use for this shipment. Some services include:
  • BoxC Post
  • BoxC Parcel (default)
  • BoxC Plus
  • BoxC Priority

More services are available and can be found in Carrier Services.
signature_confirmation

{"signature_confirmation": false}

Boolean - Request signature confirmation from the recipient upon delivery. Default is false. Not available for all services or routes. An additional fee may apply.
tax

{"tax": 10.15}

Decimal - The total tax owed/paid for this shipment in USD. Applies to DDP shipments. Read only.
terms

{"terms": "DDU"}

String - The Incoterms for this shipment that affects which routes are available. Not required. If terms is not provided then the system will pick DDU or DDP if DDU is not available. DDP shipments will include tax and duty. Options are:
  • DDU (default)
  • DDP
test

{"test": false}

Boolean - Whether or not this is a test shipment that will generate test labels. Default is false. This property is immutable.
to 

{
    "to": {
        "company_name": null,
        "name": "John Smith",
        "phone": "555-123-4562",
        "email": "john@gmail.com",
        "street1": "108 N WESTGATE WAY",
        "street2": null,
        "city": "WYLIE",
        "province": "TX",
        "postal_code": "75098",
        "country": "US"
    }
}

The recipient's shipping address. This may or may not be the same as the consignee. Required.

company_name: String(40) - The company name. Not required.
name: String(40) - The recipient's name. Required.
phone: String(20) - The recipient's phone number. Conditional.
email: String(64) - The recipient's e-mail address. Conditional.
street1: String(40) - The recipient's street address. Required.
street2: String(40) - Additional space for the recipient's street address. Not required.
city: String(40) - The recipient's city. Required.
province: String(40) - The recipient's province or state. Required.
postal_code: String(10) - The recipient's postal code or ZIP Code. Required.
country: String(2) - The recipient's country in ISO 3166-1 alpha-2 format. Required.
total_cost

{"total_cost": 3.58}

Decimal - The total shipping cost in USD. Set by the system.
updated

{"updated": "2015-05-05 15:43:03"}

String - The date and time the shipment was last updated. Set by the system.
volumetric_weight

{"volumetric_weight": .088}

Decimal - The volumetric / dimensional weight of the shipment based on the route's divisor. Set by the system.
weight

{"weight": 0.567}

Decimal - The weight of the shipment in KG. Required.
width

{"width": 8}

Decimal - The width of the shipment in cm. Not required. Default is 10.
GET
/shipments/{id}
Retrieves a shipment
request
GET /shipments/1014
response

HTTP/1.1 200 OK

{
    "shipment": {
        "carrier": "USPS",
        "claim_url": "https:\/\/www.xcover.com\/en\/account\/claims\/fnol?bookingID=AAA-AAA-AAINS",
        "comments": [
            "This is a comment"
        ],
        "consignee": {
            "name": "Addressee John",
            "phone": "555-456-7890",
            "email": null,
            "id": null,
            "street1": "2959 ANCHOR DR",
            "street2": null,
            "city": "MESQUITE",
            "province": "TX",
            "postal_code": "75150",
            "country": "US"
        },
        "consignor": {
            "name": "Generic Company, LLC",
            "phone": "555-123-4567",
            "email": "consignor@test.com",
            "id": null,
            "street1": "1 WORLD WAY",
            "street2": "",
            "city": "SHENZHEN",
            "province": "GUANGDONG",
            "postal_code": "518000",
            "country": "CN"
        },
        "created": "2015-04-30 18:21:59",
        "currency": "USD",
        "duty": 0,
        "entry_point": "SZXI01",
        "exit_point": null,
        "from": {
            "name": "My Company Name",
            "street1": "113 INTL BROADWAY",
            "street2": "",
            "city": "LOS ANGELES",
            "province": "CA",
            "postal_code": "91013",
            "country": "US"
        },
        "height": 3.5,
        "id": 1014,
        "ignore_bad_address": false,
        "insurance": false,
        "insured_value": 23,
        "irregular": false,
        "is_return": false,
        "labels": [
            {
                "cancelled": false,
                "carrier": "USPS",
                "chargeable_weight": 0.284,
                "cost": 3.56,
                "created": "2015-04-30 18:22:00",
                "delivery_date": null,
                "events": [],
                "exit_point": "CVG",
                "id": 898212,
                "insurance_fee": 0,
                "is_ready": true,
                "oversize_fee": 0,
                "processed": true,
                "processed_date": "2015-04-05",
                "processed_weight": 0.284,
                "service": "BoxC Parcel",
                "status": "En Route",
                "surcharge": 0,
                "tracking_number": "9261299991753900000290"
            }
        ],
        "length": 10,
        "line_items": [
            {
                "coo": "CN",
                "currency": "USD",
                "description": "Phone case",
                "dg_code": null,
                "duty": 0,
                "hts_code": null,
                "origin_description": "\u624b\u673a\u5916\u58f3",
                "quantity": 2,
                "tax": 0,
                "url": null,
                "weight": 0.235,
                "value": 9.95
            }
        ],
        "order_number": null,
        "overpack_id": null,
        "service": "BoxC Parcel",
        "signature_confirmation": false,
        "tax": 0,
        "terms": "DDU",
        "test": false,
        "to": {
            "company_name": null,
            "name": "John Smith",
            "phone": "555-123-4562",
            "email": "john@gmail.com",
            "street1": "108 N Westgate Way",
            "street2": null,
            "city": "Wylie",
            "province": "TX",
            "postal_code": "75098",
            "country": "US"
        },
        "total_cost": 3.56,
        "updated": "2015-04-30 18:21:59",
        "volumetric_weight": 0.088,
        "weight": 0.325,
        "width": 5
    }
}
POST
/shipments
Creates a shipment
request
POST /shipments 
{
    "shipment": {
        "carrier": null,
        "carrier_params": {
            "ekp": "2222222222",
            "contract_participation": "01",
            "cig_username": "cig_username",
            "cig_password": "cig_password",
            "tnt_username": "tnt_username",
            "tnt_password": "tnt_password",
            "retoure_username": "retoure_username",
            "retoure_password": "retoure_password",
            "receiver_id": "receiver_id",
            "label_format": "910-300-400",
            "client_id": "client_id",
            "client_secret": "client_secret",
            "pickup_id": "pickup_id",
            "distribution_center": "distribution_center"
        },
        "comments": [
            "This is a comment"
        ],
        "consignee": {
            "name": "Addressee John",
            "phone": "555-456-7890",
            "email": null,
            "id": null,
            "street1": "2959 ANCHOR DR",
            "street2": null,
            "city": "MESQUITE",
            "province": "TX",
            "postal_code": "75150",
            "country": "US"
        },
        "create_label": false,
        "currency": "USD",
        "entry_point": "SZXI01",
        "exit_point": "ORD",
        "from": {
            "name": "My Company Name",
            "street1": "113 INTL BROADWAY",
            "street2": "",
            "city": "LOS ANGELES",
            "province": "CA",
            "postal_code": "91013",
            "country": "US"
        },
        "height": 3.9,
        "ignore_bad_address": false,
        "insurance": false,
        "irregular": false,
        "is_return": false,
        "length": 10,
        "line_items": [
            {
                "coo": "CN",
                "currency": "USD",
                "description": "Phone case",
                "dg_code": null,
                "hts_code": null,
                "origin_description": "\u624b\u673a\u5916\u58f3",
                "quantity": 2,
                "url": null,
                "weight": 0.235,
                "value": 9.95
            }
        ],
        "service": "BoxC Parcel",
        "signature_confirmation": false,
        "terms": "DDU",
        "test": true,
        "to": {
            "company_name": null,
            "name": "John Smith",
            "phone": "555-123-456",
            "email": "john@gmail.com",
            "street1": "108 N Westgate Way",
            "street2": null,
            "city": "Wylie",
            "province": "TX",
            "postal_code": "75098",
            "country": "US"
        },
        "weight": 0.4,
        "width": 5
    }
}
response

HTTP/1.1 201 Created

{
    "shipment": {
        "carrier": "USPS",
        "claim_url": null,
        "comments": [
            "This is a comment"
        ],
        "consignee": {
            "name": "Addressee John",
            "phone": "555-456-7890",
            "email": null,
            "id": null,
            "street1": "2959 ANCHOR DR",
            "street2": null,
            "city": "MESQUITE",
            "province": "TX",
            "postal_code": "75150",
            "country": "US"
        },
        "consignor": {
            "name": "Generic Company, LLC",
            "phone": "555-123-4567",
            "email": "consignor@test.com",
            "id": null,
            "street1": "1 WORLD WAY",
            "street2": "",
            "city": "SHENZHEN",
            "province": "GUANGDONG",
            "postal_code": "518000",
            "country": "CN"
        },
        "created": "2015-05-04 08:10:24",
        "currency": "USD",
        "duty": 0,
        "entry_point": "SZXI01",
        "exit_point": "ORD",
        "from": {
            "name": "My Company Name",
            "street1": "113 INTL BROADWAY",
            "street2": "",
            "city": "LOS ANGELES",
            "province": "CA",
            "postal_code": "91013",
            "country": "US"
        },
        "height": 3,
        "id": 1015,
        "ignore_bad_address": false,
        "insurance": false,
        "insured_value": 23,
        "irregular": false,
        "is_return": false,
        "labels": [],
        "length": 10,
        "line_items": [
            {
                "coo": "CN",
                "currency": "USD",
                "description": "Phone case",
                "dg_code": null,
                "duty": 0,
                "hts_code": null,
                "origin_description": "\u624b\u673a\u5916\u58f3",
                "quantity": 2,
                "tax": 0,
                "url": null,
                "weight": 0.235,
                "value": 9.95
            }
        ],
        "order_number": null,
        "overpack_id": null,
        "service": "BoxC Parcel",
        "signature_confirmation": false,
        "tax": 0,
        "terms": "DDU",
        "test": true,
        "to": {
            "company_name": null,
            "name": "John Smith",
            "phone": "555-123-456",
            "email": "john@gmail.com",
            "street1": "108 N Westgate Way",
            "street2": null,
            "city": "Wylie",
            "province": "TX",
            "postal_code": "75098",
            "country": "US"
        },
        "total_cost": 3.8,
        "updated": "2015-05-04 08:10:24",
        "volumetric_weight": 0.088,
        "weight": 0.4,
        "width": 5.25
    }
}
PUT
/shipments/{id}
Updates a shipment. Only shipments with no labels or cancelled labels can be updated unless you're unassigning the shipment from an overpack by setting overpack_id to null.
request
PUT /shipments/1014 
{
    "shipment": {
        "carrier": "USPS",
        "comments": [
            "This is a comment",
            "This is the second comment"
        ],
        "consignee": {
            "name": "Addressee John",
            "phone": "555-456-7890",
            "email": null,
            "id": null,
            "street1": "2959 ANCHOR DR",
            "street2": null,
            "city": "MESQUITE",
            "province": "TX",
            "postal_code": "75150",
            "country": "US"
        },
        "consignor": {
            "name": "Generic Company, LLC",
            "phone": "555-123-4567",
            "email": "consignor@test.com",
            "id": null,
            "street1": "1 WORLD WAY",
            "street2": "",
            "city": "SHENZHEN",
            "province": "GUANGDONG",
            "postal_code": "518000",
            "country": "CN"
        },
        "create_label": false,
        "currency": "USD",
        "entry_point": "SZXI01",
        "exit_point": null,
        "height": 3.5,
        "ignore_bad_address": false,
        "insurance": false,
        "irregular": false,
        "is_return": false,
        "length": 10,
        "line_items": [
            {
                "coo": "CN",
                "currency": "USD",
                "description": "Phone case",
                "dg_code": null,
                "hts_code": null,
                "origin_description": "\u624b\u673a\u5916\u58f3",
                "quantity": 2,
                "url": null,
                "weight": 0.235,
                "value": 9.95
            }
        ],
        "service": "BoxC Parcel",
        "signature_confirmation": false,
        "terms": "DDU",
        "to": {
            "company_name": null,
            "name": "John Smith",
            "phone": "555-123-456",
            "email": "john@gmail.com",
            "street1": "101 Victory Blvd",
            "street2": "Ste 210",
            "city": "Woodland Hills",
            "province": "CA",
            "postal_code": "94101",
            "country": "US"
        },
        "weight": 0.234,
        "width": 5
    }
}
response

HTTP/1.1 200 OK

{
    "shipment": {
        "carrier": "USPS",
        "claim_url": null,
        "comments": [
            "This is a comment",
            "This is the second comment"
        ],
        "consignee": {
            "name": "Addressee John",
            "phone": "555-456-7890",
            "email": null,
            "id": null,
            "street1": "2959 ANCHOR DR",
            "street2": null,
            "city": "MESQUITE",
            "province": "TX",
            "postal_code": "75150",
            "country": "US"
        },
        "consignor": {
            "name": "Generic Company, LLC",
            "phone": "555-123-4567",
            "email": "consignor@test.com",
            "id": null,
            "street1": "1 WORLD WAY",
            "street2": "",
            "city": "SHENZHEN",
            "province": "GUANGDONG",
            "postal_code": "518000",
            "country": "CN"
        },
        "created": "2015-05-04 10:10:10",
        "currency": "USD",
        "duty": 0,
        "entry_point": "SZXI01",
        "exit_point": null,
        "from": {
            "name": "My Company Name",
            "street1": "113 INTL BROADWAY",
            "street2": "",
            "city": "LOS ANGELES",
            "province": "CA",
            "postal_code": "91013",
            "country": "US"
        },
        "height": 3.5,
        "id": 1014,
        "ignore_bad_address": false,
        "insurance": false,
        "insured_value": 23,
        "irregular": false,
        "is_return": false,
        "labels": [],
        "length": 10,
        "line_items": [
            {
                "coo": "CN",
                "currency": "USD",
                "description": "Phone case",
                "dg_code": null,
                "duty": 0,
                "hts_code": null,
                "origin_description": "\u624b\u673a\u5916\u58f3",
                "quantity": 2,
                "url": null,
                "tax": 0,
                "weight": 0.235,
                "value": 9.95
            }
        ],
        "order_number": null,
        "overpack_id": 123456,
        "service": "BoxC Parcel",
        "signature_confirmation": false,
        "tax": 0,
        "terms": "DDU",
        "test": false,
        "to": {
            "company_name": null,
            "name": "John Smith",
            "phone": "555-123-456",
            "email": "john@gmail.com",
            "street1": "101 Victory Blvd",
            "street2": "Ste 210",
            "city": "Woodland Hills",
            "province": "CA",
            "postal_code": "94101",
            "country": "US"
        },
        "total_cost": 3.12,
        "volumetric_weight": 0.088,
        "weight": 0.234,
        "width": 5
    }
}
request
PUT /shipments/1000017 
{
    "shipment": {
        "carrier": "SkyPostal",
        "comments": [
            "",
            "",
            ""
        ],
        "consignee": {
            "name": "Justin Pope",
            "phone": null,
            "email": "justin@boxc.com",
            "id": null,
            "street1": "490 SUSSEX DR",
            "street2": null,
            "city": "OTTAWA",
            "province": "ON",
            "postal_code": "K1N 1G8",
            "country": "CA"
        },
        "consignor": {
            "name": "My Company",
            "phone": "214-862-6911",
            "email": "consignor@test.com",
            "id": null,
            "street1": "1 World Way",
            "street2": "",
            "city": "Los Angeles",
            "province": "CA",
            "postal_code": "94041",
            "country": "US"
        },
        "created": "2020-08-26 16:39:47",
        "currency": "USD",
        "entry_point": "LAXI01",
        "exit_point": null,
        "from": {
            "name": "My Company 1",
            "street1": "211-6500 SILVER DART DR, CORE B",
            "street2": "P.O. BOX 6033 amf",
            "city": "MISSISSAUGA",
            "province": "ON",
            "postal_code": "L5P 1B2",
            "country": "CA"
        },
        "height": 10,
        "id": "1000017",
        "ignore_bad_address": false,
        "insurance": false,
        "irregular": false,
        "is_return": false,
        "labels": [
            {
                "cancelled": false,
                "carrier": "SkyPostal",
                "chargeable_weight": "0.250",
                "cost": 7.1,
                "created": "2020-08-26 16:59:13",
                "delivery_date": null,
                "events": [],
                "exit_point": "YYZ",
                "id": "875",
                "insurance_fee": false,
                "is_ready": true,
                "oversize_fee": "0.00",
                "processed": false,
                "processed_date": null,
                "processed_weight": null,
                "service": "BoxC Parcel",
                "status": "Pending",
                "surcharge": "0.00",
                "tracking_number": "2KNG118400631803007035400000"
            }
        ],
        "length": 5,
        "line_items": [
            {
                "coo": "US",
                "value": "10",
                "weight": ".25",
                "dg_code": null,
                "currency": "USD",
                "hts_code": null,
                "quantity": "1",
                "url": null,
                "description": "Books",
                "origin_description": "Books"
            }
        ],
        "order_number": null,
        "overpack_id": null,
        "service": "BoxC Parcel",
        "signature_confirmation": false,
        "terms": "DDP",
        "test": false,
        "to": {
            "company_name": null,
            "name": "Justin Pope",
            "phone": null,
            "email": "justin@boxc.com",
            "street1": "490 SUSSEX DR",
            "street2": null,
            "city": "OTTAWA",
            "province": "ON",
            "postal_code": "K1N 1G8",
            "country": "CA"
        },
        "total_cost": 7.1,
        "updated": "2020-08-26 17:09:35",
        "volumetric_weight": "0.083",
        "weight": 0.25,
        "width": 10
    }
}
response

HTTP/1.1 200 OK

{
    "shipment": {
        "carrier": "SkyPostal",
        "claim_url": null,
        "comments": [
            "",
            "",
            ""
        ],
        "consignee": {
            "name": "Justin Pope",
            "phone": null,
            "email": "justin@boxc.com",
            "id": null,
            "street1": "490 SUSSEX DR",
            "street2": null,
            "city": "OTTAWA",
            "province": "ON",
            "postal_code": "K1N 1G8",
            "country": "CA"
        },
        "consignor": {
            "name": "My Company",
            "phone": "214-862-6911",
            "email": "consignor@test.com",
            "id": null,
            "street1": "1 World Way",
            "street2": "",
            "city": "Los Angeles",
            "province": "CA",
            "postal_code": "94041",
            "country": "US"
        },
        "created": "2020-08-26 16:39:47",
        "currency": "USD",
        "duty": 0,
        "entry_point": "LAXI01",
        "exit_point": null,
        "from": {
            "name": "My Company 1",
            "street1": "211-6500 SILVER DART DR, CORE B",
            "street2": "P.O. BOX 6033 amf",
            "city": "MISSISSAUGA",
            "province": "ON",
            "postal_code": "L5P 1B2",
            "country": "CA"
        },
        "height": 10,
        "id": "1000017",
        "ignore_bad_address": false,
        "insurance": false,
        "insured_value": 16.5,
        "irregular": false,
        "is_return": false,
        "labels": [
            {
                "cancelled": false,
                "carrier": "SkyPostal",
                "chargeable_weight": "0.250",
                "cost": 7.1,
                "created": "2020-08-26 16:59:13",
                "delivery_date": null,
                "events": [],
                "exit_point": "YYZ",
                "id": "875",
                "insurance_fee": 0,
                'is_ready' => true,
                "oversize_fee": "0.00",
                "processed": false,
                "processed_date": null,
                "processed_weight": null,
                "service": "BoxC Parcel",
                "status": "Pending",
                "surcharge": "0.00",
                "tracking_number": "2KNG118400631803007035400000"
            }
        ],
        "length": 5,
        "line_items": [
            {
                "coo": "US",
                "duty": 0,
                "value": "10",
                "weight": ".25",
                "dg_code": null,
                "currency": "USD",
                "hts_code": null,
                "quantity": "1",
                "tax": 0,
                "url": null,
                "description": "Books",
                "origin_description": "Books"
            }
        ],
        "order_number": null,
        "overpack_id": null,
        "service": "BoxC Parcel",
        "signature_confirmation": false,
        "tax": 0,
        "terms": "DDP",
        "test": false,
        "to": {
            "company_name": null,
            "name": "Justin Pope",
            "phone": null,
            "email": "justin@boxc.com",
            "street1": "490 SUSSEX DR",
            "street2": null,
            "city": "OTTAWA",
            "province": "ON",
            "postal_code": "K1N 1G8",
            "country": "CA"
        },
        "total_cost": 7.1,
        "updated": "2020-08-26 17:09:35",
        "volumetric_weight": "0.083",
        "weight": 0.25,
        "width": 10,
        "carton_id": null
    }
}
PUT
/shipments/{id}/process
Process a shipment with the final measured weight and dimensions. Useful for clients that process shipments at their own facilities. Only select clients are authorized to perform this action. This changes shipment status to Processed and cannot be reversed.
request
PUT /shipments/1000013/process 
{
    "shipment": {
        "datetime": "2022-09-02 11:12:13",
        "fulfillment_id": null,
        "weight": 0.111,
        "length": 10,
        "width": 10,
        "height": 2,
        "irregular": false
    }
}
response

HTTP/1.1 200 OK

{
    "shipment": {
        "status": "Processed"
    }
}
DELETE
/shipments/{id}
Deletes a shipment
request
DELETE /shipments/12492
response

HTTP/1.1 200 OK