Skip to main content
Server path: /shippo-shipping | Type: Application | PCID required: Yes

Tools

ToolDescription
shippo_shipping_add_shipments_to_batchAdd shipments to a batch
shippo_shipping_create_addressCreate a new address
shippo_shipping_create_batchCreate a batch
shippo_shipping_create_live_rateGenerate a live rates request
shippo_shipping_create_manifestCreate a new manifest
shippo_shipping_create_orderCreate a new order
shippo_shipping_create_parcelCreate a new parcel
shippo_shipping_create_pickupCreate a pickup
shippo_shipping_create_refundCreate a refund
shippo_shipping_create_shipmentCreate a new shipment
shippo_shipping_create_transactionCreate a shipping label
shippo_shipping_delete_default_parcel_templateClear current default parcel template
shippo_shipping_get_addressRetrieve an address
shippo_shipping_get_batchRetrieve a batch
shippo_shipping_get_default_parcel_templateShow current default parcel template
shippo_shipping_get_manifestRetrieve a manifest
shippo_shipping_get_orderRetrieve an order
shippo_shipping_get_parcelRetrieve an existing parcel
shippo_shipping_get_rateRetrieve a rate
shippo_shipping_get_refundRetrieve a refund
shippo_shipping_get_shipmentRetrieve a shipment
shippo_shipping_get_transactionRetrieve a shipping label
shippo_shipping_list_addressesList all addresses
shippo_shipping_list_manifestsList all manifests
shippo_shipping_list_ordersList all orders
shippo_shipping_list_parcelsList all parcels
shippo_shipping_list_refundsList all refunds
shippo_shipping_list_shipment_ratesRetrieve shipment rates
shippo_shipping_list_shipment_rates_by_currency_codeRetrieve shipment rates in currency
shippo_shipping_list_shipmentsList all shipments
shippo_shipping_list_transactionsList all shipping labels
shippo_shipping_purchase_batchPurchase a batch
shippo_shipping_remove_shipments_from_batchRemove shipments from a batch
shippo_shipping_update_default_parcel_templateUpdate default parcel template
shippo_shipping_validate_addressValidate an address

shippo_shipping_add_shipments_to_batch

Add shipments to a batch Parameters:
ParameterTypeRequiredDefaultDescription
BatchIdstringYesObject ID of the batch
bodyobject[]YesArray of shipments to add to the batch

shippo_shipping_create_address

Create a new address Parameters:
ParameterTypeRequiredDefaultDescription
citystringNorequired for purchase<br> Name of a city. When creating a Quote Address, sending a city is optional but will yield more accurate Rates. Please bear in mind that city names may be ambiguous (there are 34 Springfields in the US). Pass in a state or a ZIP code (see below), if known, it will yield more accurate results. Carrier-Specific Constraints: | Carrier | Constraints | |:---|:---| | FedEx | Required; Max 35 characters |
companystringNoCompany Name Carrier-Specific Constraints: | Carrier | Constraints | |:---|:---| | FedEx | Max 35 characters; Either company or name required |
countrystringYesISO 3166-1 alpha-2 country codes and country names can be used. For most consistent results, we recommend using country codes like US or DE. If using country names, please ensure they are spelled correctly and in English. Country names are converted to country codes. Refer to this <a href=“https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements” target=“_blank”>guide</a> for a list of country codes. Sending a country is always required.
emailstringNoE-mail address of the contact person, RFC3696/5321-compliant. Carrier-Specific Constraints: | Carrier | Constraints | |:---|:---| | FedEx | Max 80 characters | | USPS | Sender email required for shipments during label purchase |
is_residentialbooleanNoIs Residential
metadatastringNoA string of up to 100 characters that can be filled with any additional information you want to attach to the object.
namestringNorequired for purchase<br> First and Last Name of the addressee Carrier-Specific Constraints: | Carrier | Constraints | |:---|:---| | FedEx | Either company or name required; No length validation (first 35 chars printed on label) |
phonestringNoAddresses containing a phone number allow carriers to call the recipient when delivering the Parcel. This increases the probability of delivery and helps to avoid accessorial charges after a Parcel has been shipped. Carrier-Specific Constraints: | Carrier | Constraints | |:---|:---| | FedEx | Required; Min 1, max 15 characters | | USPS | Sender phone required for shipments during label purchase; Min 8, max 15 digits |
statestringNorequired for purchase for some countries<br> State/Province values are required for shipments from/to the US, AU, and CA. UPS requires province for some countries (i.e Ireland). To receive more accurate quotes, passing this field is recommended. Most carriers only accept two or three character state abbreviations. Carrier-Specific Constraints: | Carrier | Constraints | |:---|:---| | FedEx | Required if country requires state; Max 2 characters for US, CA, PR |
street_nostringNoStreet number of the addressed building. This field can be included in street1 for all carriers except for DHL Germany.
street1stringNorequired for purchase<br> First street line. Usually street number and street name (except for DHL Germany, see street_no). Carrier-Specific Constraints: | Carrier | Constraints | |:---|:---| | FedEx | At least one street line required; Max 35 characters per line |
street2stringNoSecond street line. Carrier-Specific Constraints: | Carrier | Constraints | |:---|:---| | FedEx | At least one street line required; Max 35 characters per line |
street3stringNoThird street line. Only accepted for USPS international shipments, UPS domestic and UPS international shipments. Carrier-Specific Constraints: | Carrier | Constraints | |:---|:---| | FedEx | At least one street line required; Max 35 characters per line |
validatebooleanNoSet to true to validate Address object.
zipstringNorequired for purchase<br> Postal code of an Address. When creating a Quote Addresses, sending a ZIP is optional but will yield more accurate Rates. Carrier-Specific Constraints: | Carrier | Constraints | |:---|:---| | FedEx | Max 10 characters |

shippo_shipping_create_batch

Create a batch Parameters:
ParameterTypeRequiredDefaultDescription
batch_shipmentsobject[]YesArray of BatchShipment objects. The response keeps the same order as in the request array.
default_carrier_accountstringYesID of the Carrier Account object to use as the default for all shipments in this Batch. The carrier account can be changed on a per-shipment basis by changing the carrier_account in the corresponding BatchShipment object.
default_servicelevel_tokenstringYesToken of the service level to use as the default for all shipments in this Batch. The servicelevel can be changed on a per-shipment basis by changing the servicelevel_token in the corresponding BatchShipment object. <a href=“/shippoapi/public-api/service-levels”>Servicelevel tokens can be found here.</a>
label_filetypestringNoPrint format of the <a href=“https://docs.goshippo.com/docs/shipments/shippinglabelsizes/“&gt;label&lt;/a>. If empty, will use the default format set from <a href=“https://apps.goshippo.com/settings/labels”&gt;the Shippo dashboard.</a>
metadatastringNoA string of up to 100 characters that can be filled with any additional information you want to attach to the object.

shippo_shipping_create_live_rate

Generate a live rates request Parameters:
ParameterTypeRequiredDefaultDescription
address_fromobjectNoThe sender address, which includes your name, company name, street address, city, state, zip code, country, phone number, and email address (strings). Special characters should not be included in any address element, especially name, company, and email.
address_toobjectYesThe recipient address, which includes the recipient’s name, company name, street address, city, state, zip code, country, phone number, and email address (strings). Special characters should not be included in any address element, especially name, company, and email.
line_itemsany[]YesArray of Line Item objects
parcelobjectNoObject ID for an existing User Parcel Template OR a fully formed Parcel object.

shippo_shipping_create_manifest

Create a new manifest Parameters:
ParameterTypeRequiredDefaultDescription
address_fromobjectYesAddress From
asyncbooleanNoThe async value
carrier_accountstringYesID of carrier account
shipment_datestringYesAll shipments to be submitted on this day will be closed out. Must be in the format 2014-01-18T00:35:03.463Z (ISO 8601 date).
transactionsstring[]NoIDs transactions to use. If you set this to null or not send this parameter, Shippo will automatically assign all applicable transactions.

shippo_shipping_create_order

Create a new order Parameters:
ParameterTypeRequiredDefaultDescription
currencystringNoRequired if total_price is provided<br> Currency of the <code>total_price</code> and <code>total_tax</code> amounts.
from_addressobjectNo<a href=“/shippoapi/public-api/addresses”>Address</a> object of the sender / seller. Will be returned expanded by default..
line_itemsany[]NoArray of <a href=“/shippoapi/public-api/orders/lineitem”>line item</a> objects representing the items in this order. All objects will be returned expanded by default.
notesstringNoCustom buyer- or seller-provided notes about the order.
order_numberstringNoAn alphanumeric identifier for the order used by the seller/buyer. This identifier doesn’t need to be unique.
order_statusstringNoCurrent state of the order. See the <a href=“https://docs.goshippo.com/docs/orders/orders/“&gt;orders tutorial</a> for the logic of how the status is handled.
placed_atstringYesDate and time when the order was placed. This datetime can be different from the datetime of the order object creation on Shippo.
shipping_coststringNoAmount paid by the buyer for shipping. This amount can be different from the price the seller will actually pay for shipping.
shipping_cost_currencystringNoRequired if shipping_cost is provided<br> Currency of the <code>shipping_cost</code> amount.
shipping_methodstringNoShipping method (carrier + service or other free text description) chosen by the buyer. This value can be different from the shipping method the seller will actually choose.
subtotal_pricestringNoSubtotal Price
to_addressobjectYes<a href=“/shippoapi/public-api/addresses”>Address</a> object of the recipient / buyer. Will be returned expanded by default.
total_pricestringNoTotal amount paid by the buyer for this order.
total_taxstringNoTotal tax amount paid by the buyer for this order.
weightstringNoTotal weight of the order.
weight_unitstringNoThe unit used for weight.

shippo_shipping_create_parcel

Create a new parcel Parameters:
ParameterTypeRequiredDefaultDescription
bodyobjectYesParcel details.

shippo_shipping_create_pickup

Create a pickup Parameters:
ParameterTypeRequiredDefaultDescription
carrier_accountstringYesThe object ID of your USPS or DHL Express carrier account. You can retrieve this from your Rate requests or our <a href=“/shippoapi/public-api/carrier-accounts”>Carrier Accounts</a> endpoint.
locationobjectYesLocation where the parcel(s) will be picked up.
metadatastringNoA string of up to 100 characters that can be filled with any additional information you want to attach to the object.
requested_end_timestringYesThe latest that you requested your parcels to be available for pickup. Expressed in the timezone specified in the response.
requested_start_timestringYesThe earliest that you requested your parcels to be ready for pickup. Expressed in the timezone specified in the response.
transactionsstring[]YesThe transaction(s) object ID(s) for the parcel(s) that need to be picked up.

shippo_shipping_create_refund

Create a refund Parameters:
ParameterTypeRequiredDefaultDescription
asyncbooleanNoThe async value
transactionstringYesThe transaction value

shippo_shipping_create_shipment

Create a new shipment Parameters:
ParameterTypeRequiredDefaultDescription
address_fromobjectYesAddress From
address_returnobjectNoAddress Return
address_toobjectYesAddress To
asyncbooleanNoThe async value
carrier_accountsstring[]NoList of <a href=“/shippoapi/public-api/carrier-accounts”>Carrier Accounts</a> object_ids used to filter the returned rates. If set, only rates from these carriers will be returned.
customs_declarationobjectNoCustoms Declaration
extraobjectNoAn object holding optional extra services to be requested.
metadatastringNoA string of up to 100 characters that can be filled with any additional information you want to attach to the object.
parcelsany[]YesList of parcels to be shipped. Carrier-Specific Constraints: | Carrier | Constraints | |:---|:---| | FedEx | Max 30 items |
shipment_datestringNoDate the shipment will be tendered to the carrier. Must be in the format 2014-01-18T00:35:03.463Z. Defaults to current date and time if no value is provided. Please note that some carriers require this value to be in the future, on a working day, or similar.

shippo_shipping_create_transaction

Create a shipping label Parameters:
ParameterTypeRequiredDefaultDescription
bodyobjectYesExamples.

shippo_shipping_delete_default_parcel_template

Clear current default parcel template

shippo_shipping_get_address

Retrieve an address Parameters:
ParameterTypeRequiredDefaultDescription
AddressIdstringYesObject ID of the address

shippo_shipping_get_batch

Retrieve a batch Parameters:
ParameterTypeRequiredDefaultDescription
BatchIdstringYesObject ID of the batch
pageintegerNoThe page number you want to select
resultsintegerNoThe number of results to return per page (max 100, default 5)

shippo_shipping_get_default_parcel_template

Show current default parcel template

shippo_shipping_get_manifest

Retrieve a manifest Parameters:
ParameterTypeRequiredDefaultDescription
ManifestIdstringYesObject ID of the manifest to update

shippo_shipping_get_order

Retrieve an order Parameters:
ParameterTypeRequiredDefaultDescription
OrderIdstringYesObject ID of the order

shippo_shipping_get_parcel

Retrieve an existing parcel Parameters:
ParameterTypeRequiredDefaultDescription
ParcelIdstringYesObject ID of the parcel

shippo_shipping_get_rate

Retrieve a rate Parameters:
ParameterTypeRequiredDefaultDescription
RateIdstringYesObject ID of the rate

shippo_shipping_get_refund

Retrieve a refund Parameters:
ParameterTypeRequiredDefaultDescription
RefundIdstringYesObject ID of the refund to update

shippo_shipping_get_shipment

Retrieve a shipment Parameters:
ParameterTypeRequiredDefaultDescription
ShipmentIdstringYesObject ID of the shipment to update

shippo_shipping_get_transaction

Retrieve a shipping label Parameters:
ParameterTypeRequiredDefaultDescription
TransactionIdstringYesObject ID of the transaction to update

shippo_shipping_list_addresses

List all addresses Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoThe page number you want to select
resultsintegerNoThe number of results to return per page (max 100, default 5)

shippo_shipping_list_manifests

List all manifests Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoThe page number you want to select
resultsintegerNoThe number of results to return per page (max 100, default 5)

shippo_shipping_list_orders

List all orders Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoThe page number you want to select
resultsintegerNoThe number of results to return per page (max 100)
order_status[]string[]NoFilter orders by order status
shop_appstringNoFilter orders by shop app
start_datestringNoFilter orders created after the input date and time (ISO 8601 UTC format). This is based on the placed_at field, meaning when the order has been placed, not when the order object was created.
end_datestringNoFilter orders created before the input date and time (ISO 8601 UTC format). This is based on the placed_at field, meaning when the order has been placed, not when the order object was created.

shippo_shipping_list_parcels

List all parcels Parameters:
ParameterTypeRequiredDefaultDescription
pageintegerNoThe page number you want to select
resultsintegerNoThe number of results to return per page (max 100)

shippo_shipping_list_refunds

List all refunds

shippo_shipping_list_shipment_rates

Retrieve shipment rates Parameters:
ParameterTypeRequiredDefaultDescription
ShipmentIdstringYesObject ID of the shipment to update
pageintegerNoThe page number you want to select
resultsintegerNoThe number of results to return per page (max 100)

shippo_shipping_list_shipment_rates_by_currency_code

Retrieve shipment rates in currency Parameters:
ParameterTypeRequiredDefaultDescription
ShipmentIdstringYesObject ID of the shipment to update
CurrencyCodestringYesISO currency code for the rates
pageintegerNoThe page number you want to select
resultsintegerNoThe number of results to return per page (max 100)

shippo_shipping_list_shipments

List all shipments Parameters:
ParameterTypeRequiredDefaultDescription
page_tokenstringNoThe page token for paginated results
pageintegerNoThe page number you want to select
resultsintegerNoThe number of results to return per page (max 100)
object_created_gtstringNoObject(s) created greater than a provided date and time.
object_created_gtestringNoObject(s) created greater than or equal to a provided date and time.
object_created_ltstringNoObject(s) created lesser than a provided date and time.
object_created_ltestringNoObject(s) created lesser than or equal to a provided date and time.

shippo_shipping_list_transactions

List all shipping labels Parameters:
ParameterTypeRequiredDefaultDescription
ratestringNoFilter by rate ID
object_statusstringNoFilter by object status
tracking_statusstringNoFilter by tracking status
pageintegerNoThe page number you want to select
resultsintegerNoThe number of results to return per page (max 100)

shippo_shipping_purchase_batch

Purchase a batch Parameters:
ParameterTypeRequiredDefaultDescription
BatchIdstringYesObject ID of the batch

shippo_shipping_remove_shipments_from_batch

Remove shipments from a batch Parameters:
ParameterTypeRequiredDefaultDescription
BatchIdstringYesObject ID of the batch
bodystring[]YesArray of shipments object ids to remove from the batch

shippo_shipping_update_default_parcel_template

Update default parcel template Parameters:
ParameterTypeRequiredDefaultDescription
object_idstringNoObject Id

shippo_shipping_validate_address

Validate an address Parameters:
ParameterTypeRequiredDefaultDescription
AddressIdstringYesObject ID of the address