# Print labels for orders Starshipit imported
URL: https://support.starshipit.com/articles/14700000001012-print-labels-for-orders-starshipit-imported
Canonical: https://support.starshipit.com/articles/14700000001012-print-labels-for-orders-starshipit-imported
Markdown: https://support.starshipit.com/articles/14700000001012-print-labels-for-orders-starshipit-imported.md
Updated: 2026-06-18

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Use the API to print labels for orders that Starshipit imported from a connected ecommerce platform or marketplace.

Use this pattern when Starshipit imports orders through a native integration, but another system needs to trigger label generation and retrieve the label and tracking details by API.

## Before you begin

- Confirm the order already exists in Starshipit.
- Store enough source-system data to find the Starshipit order, such as order number or order ID.
- Confirm the order is ready to ship.
- Confirm shipping method, carrier rules, package details, and customs data are available.
- Decide where the returned label and tracking number will be stored.

## Recommended workflow

1. Let Starshipit import the order from the connected platform.
2. Find the order in Starshipit with [GET /api/orders/search](/developers/api-reference/starshipit#endpoint-orders-get-api-orders-search-phrase-john-20smith-search-orders), [GET /api/orders](/developers/api-reference/starshipit#endpoint-orders-get-api-orders-get-order-s), or [GET /api/orders/unshipped](/developers/api-reference/starshipit#endpoint-orders-get-api-orders-unshipped-list-orders-unshipped).
3. Update the unprinted order if required with [PUT /api/orders](/developers/api-reference/starshipit#endpoint-orders-put-api-orders-update-order).
4. Print the label with [POST /api/orders/shipment](/developers/api-reference/starshipit#endpoint-shipments-post-api-orders-shipment-print-label).
5. Store the returned label file or label URL in the external system.
6. Store the tracking number against the source order.
7. Manifest the shipment with [POST /api/manifests/shipments](/developers/api-reference/starshipit#endpoint-manifests-post-api-manifests-shipments-manifest-orders) when your process is ready.

## Endpoint map

[Open the Starshipit API reference](/developers/api-reference/starshipit#orders) for request fields and response models.

| Step | Endpoint | Use it to |
| --- | --- | --- |
| Find the order | [GET /api/orders/search](/developers/api-reference/starshipit#endpoint-orders-get-api-orders-search-phrase-john-20smith-search-orders) or [GET /api/orders](/developers/api-reference/starshipit#endpoint-orders-get-api-orders-get-order-s) | Locate the order Starshipit imported from a connected platform. |
| Update before printing | [PUT /api/orders](/developers/api-reference/starshipit#endpoint-orders-put-api-orders-update-order) | Add final address, package, customs, or service data. |
| Print the label | [POST /api/orders/shipment](/developers/api-reference/starshipit#endpoint-shipments-post-api-orders-shipment-print-label) | Generate the label and tracking number. |
| Manifest when ready | [POST /api/manifests/shipments](/developers/api-reference/starshipit#endpoint-manifests-post-api-manifests-shipments-manifest-orders) | Manifest printed shipments in your operational flow. |

## When to use this pattern

Use this pattern when Starshipit already has the best order import connection, but your warehouse or middleware system owns the print action. For example, a platform integration imports orders into Starshipit, then a WMS calls Starshipit to generate the courier label during packing.

## Verify the flow

Confirm that:

- The external system finds the correct Starshipit order.
- The order is not printed twice.
- The label belongs to the expected carrier and service.
- The returned tracking number is stored against the correct source order.
- Failed label attempts are visible to the operations team.

## Common issues

| Issue | What to check |
| --- | --- |
| Order cannot be found | Confirm the source order number matches the Starshipit order number or reference. |
| Label prints with the wrong service | Check Starshipit rules, shipping method, carrier, and service mapping. |
| Duplicate labels | Make the print action idempotent and check shipment status before printing again. |
| Missing customs or package data | Update the order before printing or complete the data in Starshipit. |

## Related guides

- [Update orders before printing](/articles/developer-center/starshipit-api/update-orders-before-printing)
- [Print outside Starshipit and return tracking](/articles/developer-center/starshipit-api/print-outside-starshipit-and-return-tracking)
- [Use webhooks and tracking updates](/articles/developer-center/starshipit-api/use-webhooks-and-tracking-updates)
- [Starshipit API reference](/developers/api-reference/starshipit#orders)