vendorShipments_GetShipmentLabels
Get small parcel transport labels from Amazon.
readAmazon Seller (SP-API)sp.vendorShipments
Amazon SP-API · GetShipmentLabels · GET /vendor/shipping/v1/transportLabels
Call it
In an AI client (MCP)
{
"name": "vendorShipments_GetShipmentLabels",
"arguments": {
"store": "myStore-US"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/vendorShipments_GetShipmentLabels \
-H "Authorization: Bearer $SELLERSHEET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"store":"myStore-US"}'Early access — the Tool API is open on request, contact us.
Arguments
| Name | Type | Description |
|---|---|---|
storerequired | string | the store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim. |
label_created_after | string · date-time | ISO 8601 — labels created after this. |
label_created_before | string · date-time | ISO 8601 — labels created before this. |
buyer_reference_number | string | Filter by buyer reference number. |
vendor_shipment_identifier | string | Filter by vendor shipment ID. |
seller_warehouse_code | string | Filter by vendor warehouse (sellingParty.partyId). |
limit | integer · 1–50 | Max records returned, 1–50 (Amazon default 50). |
sort_order | string | ASC or DESC.ASCDESC |
next_token | string | the cursor from the previous call's data.nextToken; omit for the first page. |
Result
Every tool answers {notification, data, human_action}; data carries:
data.transportLabels[]— labelData[] {labelSequenceNumber, trackingId, carrierCode, labelFormat PDF, label (the base-64 PDF)} and shipmentInformation {buyerReferenceNumber, totalLabelCount, shipMode}.data.count— number of labels returned.data.nextToken— pass to next call if present.
Workflow
- 1. Call with label_created_after/label_created_before, or buyer_reference_number / vendor_shipment_identifier. 2. While data.nextToken is present, call again with it as next_token.