# ShipEngine Shipments API

**Canonical:** https://apis.io/apis/shipengine/shipengine-shipments-api/  
**Provider:** ShipEngine — https://apis.io/providers/shipengine/  
**Base URL:** https://api.shipengine.com  
**Documentation:** https://docs.shipstation.com/apis/shipengine/openapi

ShipEngine Shipments API is one of 25 APIs that [ShipEngine](https://apis.io/providers/shipengine/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Shipments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and 1 JSON Schema.

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.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/shipments` | List shipments |
| POST | `/v1/shipments` | Create shipments |
| GET | `/v1/shipments/external_shipment_id/{external_shipment_id}` | Get shipment by external ID |
| PUT | `/v1/shipments/recognize` | Parse shipping info |
| GET | `/v1/shipments/{shipment_id}` | Get shipment by ID |
| PUT | `/v1/shipments/{shipment_id}` | Update shipment by ID |
| PUT | `/v1/shipments/{shipment_id}/cancel` | Cancel a shipment |
| GET | `/v1/shipments/{shipment_id}/rates` | Get shipment rates |
| PUT | `/v1/shipments/tags` | Update shipments tags |
| POST | `/v1/shipments/user` | Assign user to shipments |
| POST | `/v1/shipments/hold` | Hold shipments |
| POST | `/v1/shipments/restore` | Restore shipments |
| PUT | `/v1/shipments/{shipment_id}/hold` | Hold a shipment |
| PUT | `/v1/shipments/{shipment_id}/restore` | Restore a shipment |
| POST | `/v1/shipments/{shipment_id}/split` | Split a shipment |
| POST | `/v1/shipments/{shipment_id}/merge` | Merge shipments |
| GET | `/v1/shipments/{shipment_id}/tags` | Get shipment tags |
| POST | `/v1/shipments/{shipment_id}/tags/{tag_name}` | Add tag to shipment |
| DELETE | `/v1/shipments/{shipment_id}/tags/{tag_name}` | Remove tag from shipment |

## Machine-readable artifacts (4)

- **OpenAPI** — https://artifacts.apis.io/shipengine/openapi/shipengine-shipments-api-openapi.yml
- **Documentation** — https://docs.shipstation.com/apis/shipengine/docs/getting-started/get-started
- **APIReference** — https://docs.shipstation.com/apis/shipengine/openapi
- **JSONSchema** — https://artifacts.apis.io/shipengine/json-schema/index.json

## Other ShipEngine APIs (12)

- [ShipEngine Account API](https://apis.io/apis/shipengine/shipengine-account-api/)
- [ShipEngine Addresses API](https://apis.io/apis/shipengine/shipengine-addresses-api/)
- [ShipEngine Batches API](https://apis.io/apis/shipengine/shipengine-batches-api/)
- [ShipEngine Carrier Accounts API](https://apis.io/apis/shipengine/shipengine-carrier-accounts-api/)
- [ShipEngine Carriers API](https://apis.io/apis/shipengine/shipengine-carriers-api/)
- [ShipEngine Checkout Rates API](https://apis.io/apis/shipengine/shipengine-checkout-rates-api/)
- [ShipEngine Delivery Predictions API](https://apis.io/apis/shipengine/shipengine-delivery-predictions-api/)
- [ShipEngine Documents API](https://apis.io/apis/shipengine/shipengine-documents-api/)
- [ShipEngine Downloads API](https://apis.io/apis/shipengine/shipengine-downloads-api/)
- [ShipEngine Freight API](https://apis.io/apis/shipengine/shipengine-freight-api/)
- [ShipEngine Insurance API](https://apis.io/apis/shipengine/shipengine-insurance-api/)
- [ShipEngine Labels API](https://apis.io/apis/shipengine/shipengine-labels-api/)

## Tags

Shipments

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/shipengine/shipengine-shipments-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/shipengine/.
