diff --git a/docs/index.html b/docs/index.html index c561f25..98cb2fe 100644 --- a/docs/index.html +++ b/docs/index.html @@ -355,7 +355,7 @@ 55.627 l 55.6165,55.627 -231.245496,231.24803 c -127.185,127.1864 -231.5279,231.248 -231.873,231.248 -0.3451,0 -104.688, -104.0616 -231.873,-231.248 z - " fill="currentColor">

ShipEngine API (1.1.202006241706)

Download OpenAPI specification:Download

ShipEngine Sales & Support: sales@shipengine.com URL: https://www.shipengine.com/contact/ Terms of Service

ShipEngine's easy-to-use REST API lets you manage all of your shipping needs without worrying about the complexities of different carrier APIs and protocols. We handle all the heavy lifting so you can focus on providing a first-class shipping experience for your customers at the best possible prices.

+ " fill="currentColor">

ShipEngine API (1.1.202006302006)

Download OpenAPI specification:Download

ShipEngine Sales & Support: sales@shipengine.com URL: https://www.shipengine.com/contact/ Terms of Service

ShipEngine's easy-to-use REST API lets you manage all of your shipping needs without worrying about the complexities of different carrier APIs and protocols. We handle all the heavy lifting so you can focus on providing a first-class shipping experience for your customers at the best possible prices.

Each of ShipEngine's features can be used by itself or in conjunction with each other to build powerful shipping functionality into your application or service.

ShipEngine's documentation is designed to help you start shipping as quickly as possible. With easy-to-follow tutorials, detailed reference docs, and ready-made recipes for common use cases, you'll see real results in no time at all.

Getting Started

If you're new to REST APIs then be sure to read our introduction to REST to understand the basics. Learn how to authenticate yourself to ShipEngine, and then use our sandbox environment to kick the tires and get familiar with our API. If you run into any problems, then be sure to check the error handling guide for tips.

@@ -1102,7 +1102,7 @@

This error will automatically be reported to our engineers.

-
post/v1/rates
https://api.shipengine.com/v1/rates

Request samples

Content type
application/json
Example
shipment_id_request
Copy
 Expand all Collapse all
{
  • "shipment_id": "se-28529731",
  • "rate_options":
    {
    }
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "shipment_id": "se-28529731",
  • "carrier_id": "se-28529731",
  • "service_code": "usps_first_class_mail",
  • "external_order_id": "string",
  • "items": [ ],
  • "external_shipment_id": "string",
  • "ship_date": "2018-09-23T00:00:00.000Z",
  • "created_at": "2018-09-23T15:00:00.000Z",
  • "modified_at": "2018-09-23T15:00:00.000Z",
  • "shipment_status": "pending",
  • "ship_to":
    {
    },
  • "ship_from":
    {
    },
  • "warehouse_id": "se-28529731",
  • "return_to":
    {
    },
  • "confirmation": "none",
  • "customs":
    {
    },
  • "advanced_options":
    {
    },
  • "insurance_provider": "none",
  • "tags": [ ],
  • "order_source_code": "amazon_ca",
  • "packages":
    [
    ],
  • "total_weight":
    {
    },
  • "rate_response":
    {
    }
}

Get Bulk Rates

Get Bulk Shipment Rates

+
post/v1/rates
https://api.shipengine.com/v1/rates

Request samples

Content type
application/json
Example
shipment_id_request
Copy
 Expand all Collapse all
{
  • "shipment_id": "se-28529731",
  • "rate_options":
    {
    }
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "shipment_id": "se-28529731",
  • "carrier_id": "se-28529731",
  • "service_code": "usps_first_class_mail",
  • "external_order_id": "string",
  • "items": [ ],
  • "external_shipment_id": "string",
  • "ship_date": "2018-09-23T00:00:00.000Z",
  • "created_at": "2018-09-23T15:00:00.000Z",
  • "modified_at": "2018-09-23T15:00:00.000Z",
  • "shipment_status": "pending",
  • "ship_to":
    {
    },
  • "ship_from":
    {
    },
  • "warehouse_id": "se-28529731",
  • "return_to":
    {
    },
  • "confirmation": "none",
  • "customs":
    {
    },
  • "advanced_options":
    {
    },
  • "insurance_provider": "none",
  • "tags": [ ],
  • "order_source_code": "amazon_ca",
  • "packages":
    [
    ],
  • "total_weight":
    {
    },
  • "rate_response":
    {
    }
}

Get Bulk Rates

Get Bulk Shipment Rates

Authorizations:
api_key
Request Body schema: application/json
One of
  • rate_request_by_shipment_ids
  • rate_request_by_shipments
shipment_ids
required
Array of strings

The array of shipment IDs

rate_options
required
object

The rate options

Responses

200

The request was a success.

@@ -1132,7 +1132,7 @@

This error will automatically be reported to our engineers.

-
post/v1/rates/estimate
https://api.shipengine.com/v1/rates/estimate

Request samples

Content type
application/json
Example
rate_estimate_by_carrier_id
Copy
 Expand all Collapse all
{
  • "carrier_id": "se-28529731",
  • "from_country_code": "CA",
  • "from_postal_code": "78756-3717",
  • "from_city_locality": "Austin",
  • "from_state_province": "Austin",
  • "to_country_code": "CA",
  • "to_postal_code": "78756-3717",
  • "to_city_locality": "Austin",
  • "to_state_province": "Houston",
  • "weight":
    {
    },
  • "dimensions":
    {
    },
  • "confirmation": "none",
  • "address_residential_indicator": "unknown",
  • "ship_date": "2018-09-23T15:00:00.000Z"
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Get Rate By ID

Retrieve a previously queried rate by its ID

+
post/v1/rates/estimate
https://api.shipengine.com/v1/rates/estimate

Request samples

Content type
application/json
Example
rate_estimate_by_carrier_id
Copy
 Expand all Collapse all
{
  • "carrier_id": "se-28529731",
  • "from_country_code": "CA",
  • "from_postal_code": "78756-3717",
  • "from_city_locality": "Austin",
  • "from_state_province": "Austin",
  • "to_country_code": "CA",
  • "to_postal_code": "78756-3717",
  • "to_city_locality": "Austin",
  • "to_state_province": "Houston",
  • "weight":
    {
    },
  • "dimensions":
    {
    },
  • "confirmation": "none",
  • "address_residential_indicator": "unknown",
  • "ship_date": "2018-09-23T15:00:00.000Z"
}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    }
]

Get Rate By ID

Retrieve a previously queried rate by its ID

Authorizations:
api_key
path Parameters
rate_id
required
string (se_id) [ 1 .. 25 ] characters ^se(-[a-z0-9]+)+$
Example: se-28529731

Rate ID

Responses

200

The request was a success.

400

The request contained errors.

@@ -1141,7 +1141,7 @@

This error will automatically be reported to our engineers.

-
get/v1/rates/{rate_id}
https://api.shipengine.com/v1/rates/{rate_id}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "rate_id": "se-28529731",
  • "rate_type": "check",
  • "carrier_id": "se-28529731",
  • "shipping_amount":
    {
    },
  • "insurance_amount":
    {
    },
  • "confirmation_amount":
    {
    },
  • "other_amount":
    {
    },
  • "tax_amount":
    {
    },
  • "zone": 6,
  • "package_type": "package",
  • "delivery_days": 5,
  • "guaranteed_service": true,
  • "estimated_delivery_date": "2018-09-23T00:00:00.000Z",
  • "carrier_delivery_days": "string",
  • "ship_date": "2020-06-24T17:40:58Z",
  • "negotiated_rate": true,
  • "service_type": "string",
  • "service_code": "string",
  • "trackable": true,
  • "carrier_code": "string",
  • "carrier_nickname": "string",
  • "carrier_friendly_name": "string",
  • "validation_status": "valid",
  • "warning_messages":
    [
    ],
  • "error_messages":
    [
    ]
}

Shipments

Shipments are at the center of the ShipEngine API. A shipment is the first step in creating a shipping label, or creating a manifest. It's also essential for getting shipping rates.

+
get/v1/rates/{rate_id}
https://api.shipengine.com/v1/rates/{rate_id}

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "rate_id": "se-28529731",
  • "rate_type": "check",
  • "carrier_id": "se-28529731",
  • "shipping_amount":
    {
    },
  • "insurance_amount":
    {
    },
  • "confirmation_amount":
    {
    },
  • "other_amount":
    {
    },
  • "tax_amount":
    {
    },
  • "zone": 6,
  • "package_type": "package",
  • "delivery_days": 5,
  • "guaranteed_service": true,
  • "estimated_delivery_date": "2018-09-23T00:00:00.000Z",
  • "carrier_delivery_days": "string",
  • "ship_date": "2020-07-01T01:13:18Z",
  • "negotiated_rate": true,
  • "service_type": "string",
  • "service_code": "string",
  • "trackable": true,
  • "carrier_code": "string",
  • "carrier_nickname": "string",
  • "carrier_friendly_name": "string",
  • "validation_status": "valid",
  • "warning_messages":
    [
    ],
  • "error_messages":
    [
    ]
}

Shipments

Shipments are at the center of the ShipEngine API. A shipment is the first step in creating a shipping label, or creating a manifest. It's also essential for getting shipping rates.

Learn about the shipment object model concept, and how to persist and re-use shipment data inside ShipEngine.

List Shipments

Get list of Shipments

Authorizations:
api_key
query Parameters
shipment_status
string (shipment_status)
Enum: "pending" "processing" "label_purchased" "cancelled"

The possible shipment status values

@@ -1269,7 +1269,7 @@

This error will automatically be reported to our engineers.

-
get/v1/shipments/{shipment_id}/rates
https://api.shipengine.com/v1/shipments/{shipment_id}/rates

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "rates":
    [
    ],
  • "invalid_rates": [ ],
  • "rate_request_id": "se-28529731",
  • "shipment_id": "se-28529731",
  • "created_at": "se-28529731",
  • "status": "working",
  • "errors":
    [
    ]
}

Add Tag to Shipment

Add a tag to the shipment object

+
get/v1/shipments/{shipment_id}/rates
https://api.shipengine.com/v1/shipments/{shipment_id}/rates

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "rates":
    [
    ],
  • "invalid_rates": [ ],
  • "rate_request_id": "se-28529731",
  • "shipment_id": "se-28529731",
  • "created_at": "se-28529731",
  • "status": "working",
  • "errors":
    [
    ]
}

Add Tag to Shipment

Add a tag to the shipment object

Authorizations:
api_key
path Parameters
shipment_id
required
string (se_id) [ 1 .. 25 ] characters ^se(-[a-z0-9]+)+$
Example: se-28529731

Shipment ID

tag_name
required
string (tag_name) non-empty
Example: Fragile

Tags are arbitrary strings that you can use to categorize shipments. For example, you may want to use tags to distinguish between domestic and international shipments, or between insured and uninsured shipments. Or maybe you want to create a tag for each of your customers so you can easily retrieve every shipment for a customer.

Responses

200

The requested object creation was a success.

@@ -1457,7 +1457,7 @@
delete/v1/environment/webhooks/{webhook_id}
https://api.shipengine.com/v1/environment/webhooks/{webhook_id}

Response samples

Content type
text/plain
No sample