List Shipments
GET {{baseUrl}}/shipments?order_id=<integer>&courier_id=<integer>&courier_slug=<string>&status=created&shipment_type=shipment&payment_method=pre_paid&from_date=YYYY-MM-DD&to_date=YYYY-MM-DD&ship_to[country_id]=<integer>&ship_to[country_code]=<string>&ship_to[city_id]=<integer>&ship_from[country_id]=<integer>&ship_from[country_code]=<string>&ship_from[city_id]=<integer>&source=api
This endpoint allows you to list all shipments related to your store directly from this endpoint. Also, it allows you to filter them using by shipping company slug.
shipping.read
- Shipping Read Only
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
order_id | string | Order ID. Get a list of Order IDs from here | |
courier_id | string | Courier ID. Get a list of Courier IDs from here | |
courier_slug | string | Courier Slug. Get a list of Courier Slugs from here | |
status | string | Shipment Status; value can be one of the listed enum variables | |
shipment_type | string | Shipment Type; value can either "shipment" or "return" | |
payment_method | string | Payment Method; value can either "pre_paid" or "cod" | |
from_date | string | Shipment starting date range | |
to_date | string | Shipment ending date range | |
ship_to[country_id] | string | Shipment Country Destination. Get a list of Country IDs from here | |
ship_to[country_code] | string | Shipment Country Code Destination. Get a list of Country Codes from here | |
ship_to[city_id] | string | Shipment City Destination. Get a list of City IDs from here | |
ship_from[country_id] | string | Shipment Country Origin. Get a list of Country IDs from here | |
ship_from[country_code] | string | Shipment Country Code Origin. Get a list of Country Codes from here | |
ship_from[city_id] | string | Shipment City Origin. Get a list of City IDs from here | |
source | string | Shipment Source; value can be one of the listed enum variables |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"status":"\u003cnumber\u003e","success":"\u003cboolean\u003e","data":[{"id":"\u003cnumber\u003e","order_id":"\u003cnumber\u003e","order_reference_id":"\u003cnumber\u003e","created_at":{"date":"\u003cstring\u003e","timezone_type":"\u003cinteger\u003e","timezone":"\u003cstring\u003e"},"type":"return","courier_id":"\u003cinteger\u003e","courier_name":"\u003cstring\u003e","courier_logo":"\u003cstring\u003e","shipping_number":"\u003cstring\u003e","tracking_number":"\u003cstring\u003e","pickup_id":"\u003cnumber\u003e","trackable":"\u003cboolean\u003e","tracking_link":"\u003cstring\u003e","label":{"format":"\u003cstring\u003e","url":"\u003cstring\u003e"},"payment_method":"cod","source":"\u003cstring\u003e","status":"cancelled","total":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"cash_on_delivery":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"is_international":"\u003cboolean\u003e","total_weight":{"value":"\u003cnumber\u003e","units":"\u003cstring\u003e"},"packages":[{"item_id":"\u003cinteger\u003e","external_id":"\u003cinteger\u003e","name":"\u003cstring\u003e","sku":"\u003cstring\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"quantity":"\u003cinteger\u003e","weight":{"value":"\u003cinteger\u003e","units":"oz"}},{"item_id":"\u003cinteger\u003e","external_id":"\u003cinteger\u003e","name":"\u003cstring\u003e","sku":"\u003cstring\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"quantity":"\u003cinteger\u003e","weight":{"value":"\u003cinteger\u003e","units":"oz"}}],"ship_from":{"type":"\u003cstring\u003e","name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e","country":"\u003cstring\u003e","city":"\u003cstring\u003e","address_line":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","latitude":"\u003cnumber\u003e","longitude":"\u003cnumber\u003e","branch_id":"\u003cinteger\u003e"},"ship_to":{"type":"\u003cstring\u003e","name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e","country":"\u003cstring\u003e","city":"\u003cstring\u003e","address_line":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","latitude":"\u003cnumber\u003e","longitude":"\u003cnumber\u003e"},"meta":{"app_id":"\u003cinteger\u003e","policy_options":{"shipment_content_type":["liquid","food_stuff"],"packaging_type":["box","basket"],"boxes":"\u003cinteger\u003e"}}},{"id":"\u003cnumber\u003e","order_id":"\u003cnumber\u003e","order_reference_id":"\u003cnumber\u003e","created_at":{"date":"\u003cstring\u003e","timezone_type":"\u003cinteger\u003e","timezone":"\u003cstring\u003e"},"type":"return","courier_id":"\u003cinteger\u003e","courier_name":"\u003cstring\u003e","courier_logo":"\u003cstring\u003e","shipping_number":"\u003cstring\u003e","tracking_number":"\u003cstring\u003e","pickup_id":"\u003cnumber\u003e","trackable":"\u003cboolean\u003e","tracking_link":"\u003cstring\u003e","label":{"format":"\u003cstring\u003e","url":"\u003cstring\u003e"},"payment_method":"cod","source":"\u003cstring\u003e","status":"delivered","total":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"cash_on_delivery":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"is_international":"\u003cboolean\u003e","total_weight":{"value":"\u003cnumber\u003e","units":"\u003cstring\u003e"},"packages":[{"item_id":"\u003cinteger\u003e","external_id":"\u003cinteger\u003e","name":"\u003cstring\u003e","sku":"\u003cstring\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"quantity":"\u003cinteger\u003e","weight":{"value":"\u003cinteger\u003e","units":"kg"}},{"item_id":"\u003cinteger\u003e","external_id":"\u003cinteger\u003e","name":"\u003cstring\u003e","sku":"\u003cstring\u003e","price":{"amount":"\u003cnumber\u003e","currency":"\u003cstring\u003e"},"quantity":"\u003cinteger\u003e","weight":{"value":"\u003cinteger\u003e","units":"kg"}}],"ship_from":{"type":"\u003cstring\u003e","name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e","country":"\u003cstring\u003e","city":"\u003cstring\u003e","address_line":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","latitude":"\u003cnumber\u003e","longitude":"\u003cnumber\u003e","branch_id":"\u003cinteger\u003e"},"ship_to":{"type":"\u003cstring\u003e","name":"\u003cstring\u003e","email":"\u003cstring\u003e","phone":"\u003cstring\u003e","country":"\u003cstring\u003e","city":"\u003cstring\u003e","address_line":"\u003cstring\u003e","street_number":"\u003cstring\u003e","block":"\u003cstring\u003e","postal_code":"\u003cstring\u003e","latitude":"\u003cnumber\u003e","longitude":"\u003cnumber\u003e"},"meta":{"app_id":"\u003cinteger\u003e","policy_options":{"shipment_content_type":["dry","dry"],"packaging_type":["buble_wrapper","basket"],"boxes":"\u003cinteger\u003e"}}}],"pagination":{"count":"\u003cnumber\u003e","total":"\u003cnumber\u003e","perPage":"\u003cnumber\u003e","currentPage":"\u003cnumber\u003e","totalPages":"\u003cnumber\u003e","links":{"next":"\u003cstring\u003e","previous":"\u003cstring\u003e"}}}