vendorShipments_GetShipmentDetails
Get shipment details from Amazon with date and status filters.
readAmazon Seller (SP-API)sp.vendorShipments
Amazon SP-API · GetShipmentDetails · GET /vendor/shipping/v1/shipments
Call it
In an AI client (MCP)
{
"name": "vendorShipments_GetShipmentDetails",
"arguments": {
"store": "myStore-US"
}
}From code (Tool API)
curl -X POST https://api.sellersheetai.com/api/v1/tools/vendorShipments_GetShipmentDetails \
-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. |
created_after | string · date-time | ISO 8601 — shipment record created after. |
created_before | string · date-time | ISO 8601 — shipment record created before. |
shipment_confirmed_before | string · date-time | ISO 8601 — confirmed date upper bound. |
shipment_confirmed_after | string · date-time | ISO 8601 — confirmed date lower bound. |
package_label_created_before | string · date-time | ISO 8601 — buyer label creation date upper bound. |
package_label_created_after | string · date-time | ISO 8601 — buyer label creation date lower bound. |
shipped_before | string · date-time | ISO 8601 — shipped date upper bound. |
shipped_after | string · date-time | ISO 8601 — shipped date lower bound. |
estimated_delivery_before | string · date-time | ISO 8601 — estimated delivery upper bound. |
estimated_delivery_after | string · date-time | ISO 8601 — estimated delivery lower bound. |
shipment_delivery_before | string · date-time | ISO 8601 — actual delivery upper bound. |
shipment_delivery_after | string · date-time | ISO 8601 — actual delivery lower bound. |
requested_pick_up_before | string · date-time | ISO 8601 — requested pick-up upper bound. |
requested_pick_up_after | string · date-time | ISO 8601 — requested pick-up lower bound. |
scheduled_pick_up_before | string · date-time | ISO 8601 — scheduled pick-up upper bound. |
scheduled_pick_up_after | string · date-time | ISO 8601 — scheduled pick-up lower bound. |
current_shipment_status | string | filter by shipment status. Allowed: Created | TransportationRequested | CarrierAssigned | Shipped. |
vendor_shipment_identifier | string | Filter by vendor's own shipment ID. |
buyer_reference_number | string | Filter by Amazon buyer reference number. |
buyer_warehouse_code | string | shipToParty.partyId value from the shipment. |
seller_warehouse_code | string | sellingParty.partyId value from the shipment. |
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.shipments— list of shipment detail dicts.data.count— number of shipments returned.data.nextToken— pass to next call if present.
Workflow
- 1. Call with created_after/created_before to fetch recent shipments. 2. Narrow by a date pair (shipped_*, shipment_confirmed_*, estimated_delivery_*, shipment_delivery_*, requested_pick_up_*, scheduled_pick_up_*) or an identifier (vendor_shipment_identifier, buyer_reference_number, buyer_warehouse_code, seller_warehouse_code). 3. While data.nextToken is present, call again with it as next_token.