Order

Manages orders, including processing, tracking, and updating order status.

Bag

Bag represents a virtual entity to group same items which contains single or multi quantity. Bags are part of a shipment. An order will have one or more than one shipments. A shipment can contain zero or more bags.

Operations
GET
/service/application/order/v1.0/orders/shipments/{shipment_id}/bags/{bag_id}/reasons
# List bag cancellation reasons
GET

List bag cancellation reasons

Get reasons to perform full or partial cancellation of a bag.
Parameters
shipment_id
string
Required
ID of the shipment. An order may contain multiple items and may get divided into one or more shipment, each having its own ID.
bag_id
string
Required
ID of the bag. An shipment may contain multiple items and may get divided into one or more bags, each having its own ID.
Response
200
4XX
5XX
Success. Check the example shown below or refer `ShipmentBagReasons` for more details.
ShipmentBagReasons
reasons
array of object (BagReasons)
A list of shipment's bag reasons.
Array of BagReasons
qc_type
array of string
A list of quality check types.
id
integer
The unique identifier.
display_name
string
The text displayed.
meta
object (BagReasonMeta)
BagReasonMeta
show_text_area
boolean
Indicates whether to display a text box on the front end.
question_set
array of object (QuestionSet)
A list of questions for delivery partner.
Array of QuestionSet
id
integer
The unique identifier for the question.
display_name
string
The text displayed for the question.
reasons
array of object (BagReasons)
A list of reasons.
Array of BagReasons
success
boolean
Indicates if the operation was successful.
Examples
Parameters
shipment_id:
"value"
bag_id:
"value"
GET
/service/application/order/v1.0/orders/shipments/{shipment_id}/bags/{bag_id}/reasons
Loading...
Response
Loading...

Order

Order represents a customer's intent to purchase a specific set of products from your platform. Here platform could be a Website, POS machine, External integrations etc. It typically includes details like customer information, billing/shipping addresses, items ordered, quantities, pricing, and chosen fulfillment method. Meta of an order can be edited.

Operations
GET
/service/application/order/v1.0/orders
# List customer orders
GET
/service/application/order/v1.0/orders/{order_id}
# Get an order
GET

List customer orders

Get all orders associated with a customer account.
Parameters
status
integer
A filter to retrieve orders by their current status such as 'placed', 'delivered' etc.
page_no
integer
The page number to navigate through the given set of results. Default value is 1.
page_size
integer
The number of items to retrieve in each page. Default value is 10.
from_date
string
The date from which the orders should be retrieved.
to_date
string
The date till which the orders should be retrieved.
start_date
string
| date-time
Start date in UTC (ISO-8601 format).
end_date
string
| date-time
End date in UTC (ISO-8601 format).
custom_meta
string
A filter and retrieve data using special fields included for special use-cases.
Default Value : 6388422a5ebd6a6cf4a8ede6
allow_inactive
boolean
Flag indicating whether inactive shipments are allowed.
Default Value : false
Response
200
4XX
5XX
Success. Returns all the orders. Check the example shown below or refer `OrderList` for more details.
OrderList
page
object (OrderPage)
OrderPage
type
string
Specifies type of pagination. If it is 'cursor' based or 'number' based.
item_total
integer
Total number of items available across all pages. It provides a count of all the items that match the query criteria, regardless of pagination.
current
integer
Specifies the current page number. It helps in identifying the position within the paginated results.
size
integer
Represents the number of items on the current page. It indicates how many items are included in each page of the paginated response.
has_next
boolean
Indicates whether there is a next page available. It is true if a next page exists and false if the current page is the last one.
items
array of object (OrderSchema)
List of orders, each containing detailed information about individual orders and their respective shipments.
Array of OrderSchema
total_shipments_in_order
integer
The total number of shipments in the order.
gstin_code
string
The GSTIN code for the shipment.
user_info
object (UserInfo)
UserInfo
first_name
string
First name of the user.
gender
string
Gender of the user.
name
string
Full name of the user (including first and last names).
last_name
string
Last name of the user.
mobile
string
Mobile number of the user.
email
string
Email address of the user.
breakup_values
array of object (BreakupValues)
An array containing the breakup of various charges and discounts.
Array of BreakupValues
value
number
The numerical value associated with the entity.
currency_symbol
string
Symbol representing the currency used for the value.
name
string
The official name of the entity.
display
string
The name of the entity as it should be displayed.
currency_code
string
The international currency code representing the currency used for the value.
order_created_time
string
The date and time when the order was created.
order_created_ts
string
The timestamp when the order was created.
order_id
string
The unique identifier for the order.
shipments
array of object (Shipments)
An array containing details of individual shipments within the order.
Array of Shipments
payment
object (ShipmentPayment)
ShipmentPayment
mop
string
Abbreviation or code for the payment mode.
payment_mode
string
The specific payment mode used.
status
string
The current status of the payment.
mode
string
The payment mode.
logo
string
URL of the logo representing the payment mode.
display_name
string
The name to be displayed for the payment mode.
payment_info
array of object (ShipmentPaymentInfo)
Array of objects containing payment methods used for placing an order. Each object will provide information about corresponding payment method with relevant details.
Array of ShipmentPaymentInfo
mop
string
Stands for "Mode of Payment". This is a short code (like "COD" for Cash On Delivery) that represents the payment method used.
payment_mode
string
Information about the payment mode, indicates whether COD or PREPAID.
status
string
Indicates the current status of the payment, Paid or Unpaid.
mode
string
Information about the payment source. For eg, NB_ICICI.
logo
string
A URL to an image representing the payment method.
display_name
string
The name of the payment method as it should be displayed to the user.
amount
number
Amount paid using this payment method.
order_type
string
Nullable
The type of order.
gstin_code
string
The GSTIN code for the shipment.
show_download_invoice
boolean
Indicates if the download invoice option should be shown.
can_cancel
boolean
Indicates if the shipment can be canceled.
user_info
object (ShipmentUserInfo)
ShipmentUserInfo
first_name
string
The unique identifier of the store.
gender
string
A code associated with the store.
name
string
The name of the store.
last_name
string
The name of the company associated with the store.
mobile
string
The identifier of the company associated with the store.
email
string
Email address of the user.
shipment_id
string
The unique identifier for the shipment.
fulfilling_store
object (FulfillingStore)
FulfillingStore
id
integer
The unique identifier of the store.
code
string
A code associated with the store.
name
string
The name of the store.
company_name
string
The name of the company associated with the store.
company_id
integer
The identifier of the company associated with the store.
custom_meta
array of object
An object containing custom metadata for the shipment.
shipment_status
object (ShipmentStatus)
ShipmentStatus
value
string
Nullable
The internal or code value representing the shipment status.
title
string
The title or display name representing the shipment status.
hex_code
string
The hexadecimal color code associated with the shipment status.
comment
string
Any comments related to the shipment.
invoice
object (Invoice)
Invoice
invoice_url
string
URL providing access to the invoice.
updated_date
string
The date and time when the invoice was last updated.
label_url
string
URL providing access to the invoice label.
show_track_link
boolean
Indicates if the track link should be shown.
refund_details
object
An object containing details of any refunds.
breakup_values
array of object (BreakupValues)
An array containing the breakup of various charges and discounts.
Array of BreakupValues
value
number
The numerical value associated with the entity.
currency_symbol
string
Symbol representing the currency used for the value.
name
string
The official name of the entity.
display
string
The name of the entity as it should be displayed.
currency_code
string
The international currency code representing the currency used for the value.
can_break
object
An object containing details about the breakability of the shipment.
traking_no
string
The tracking number for the shipment.
tracking_details
array of object (TrackingDetails)
An array containing details of the tracking history of the shipment.
Array of TrackingDetails
value
string
Nullable
Current value or state of the process.
is_current
boolean
Indicates whether the tracking event is the current or active status.
is_passed
boolean
Indicates whether the tracking event has passed or occurred.
status
string
The status of the tracking event.
time
string
The time associated with the tracking event.
created_ts
string
Timestamp when this status was created.
tracking_details
array of object (NestedTrackingDetails)
Nested tracking details.
Array of NestedTrackingDetails
is_passed
boolean
Indicates whether the tracking event has passed or occurred.
time
string
The time associated with the tracking event.
is_current
boolean
Indicates whether the tracking event is the current or active status.
status
string
The status of the tracking event.
promise
object (Promise)
Promise
show_promise
boolean
Indicates whether the promise details should be shown.
timestamp
object (TimeStampData)
TimeStampData
min
string
The minimum timestamp value.
max
string
The maximum timestamp value.
total_bags
integer
The total number of bags in the shipment.
total_details
object (ShipmentTotalDetails)
ShipmentTotalDetails
pieces
integer
The total number of pieces included.
total_price
number
The total price of the order or item.
sizes
integer
The number of different sizes included.
prices
object (Prices)
Prices
delivery_charge
number
The delivery charge for the order.
coupon_value
number
The value of the coupon applied.
brand_calculated_amount
number
The amount calculated by the brand.
value_of_good
number
The value of the goods before tax and other charges.
price_marked
number
The original marked price of the item.
coupon_effective_discount
number
The effective discount from coupons.
currency_symbol
string
The symbol of the currency used.
discount
number
The discount applied to the item.
gst_tax_percentage
number
The GST tax percentage applied.
cod_charges
number
The cash on delivery charges, if applicable.
amount_paid
number
The total amount paid by the customer.
added_to_fynd_cash
boolean
Indicates if the refund amount was added to Fynd Cash.
transfer_price
number
The transfer price of the item.
cashback_applied
number
The amount of cashback applied.
price_effective
number
The effective price after all adjustments.
cashback
number
The cashback amount earned.
refund_credit
number
The amount credited for refund .
amount_paid_roundoff
number
The rounded-off amount paid by the customer.
promotion_effective_discount
number
The effective discount from promotions.
refund_amount
number
The amount refunded to the customer.
currency_code
string
The code of the currency used.
fynd_credits
number
The amount of Fynd credits used.
amount_to_be_collected
number
The total amount that needs to be collected from the customer.
returnable_date
string
Nullable
The last date by which the item can be returned.
shipment_created_at
string
The date and time when the shipment was created.
shipment_created_ts
string
The timestamp when the shipment was created.
size_info
object
An object containing size information for the items in the shipment.
bags
array of object (Bags)
An array containing details about the individual bags in the shipment.
Array of Bags
delivery_date
string
Nullable
The date and time when the item is expected to be delivered .
line_number
integer
The line number of the item in the order.
currency_symbol
string
The symbol of the currency used.
item
object (Item)
Item
image
array of string
An array of URLs pointing to images of the item.
l1_categories
array of string
An array of level 1 categories to which the item belongs.
l2_category
array of string
An array of level 2 categories to which the item belongs.
l2_category_id
number
ID representing the level 2 category classification of the item
brand
object (ItemBrand)
ItemBrand
logo
string
The URL of the brand's logo.
name
string
The name of the brand.
seller_identifier
string
The identifier for the seller .
code
string
The code or SKU of the item.
id
number
The unique identifier of the item.
name
string
The name of the item.
l3_category_name
string
The level 3 category name.
slug_key
string
A unique key or identifier for the item slug.
l2_categories
array of string
An array of level 2 categories the item belongs to.
size
string
The size of the item.
attributes
object
An object containing various attributes of the item.
applied_promos
array of object (AppliedPromos)
An array containing information about applied promotions.
Array of AppliedPromos
mrp_promotion
boolean
Indicates if the promotion is applied to the MRP.
promotion_name
string
The name of the promotion .
article_quantity
number
The quantity of articles required to qualify for the promotion.
promo_id
string
The unique identifier for the promotion.
amount
number
The discount amount provided by the promotion.
promotion_type
string
The type of promotion.
applied_free_articles
array of object (AppliedFreeArticles)
An array containing details of free articles applied under the promotion.
Array of AppliedFreeArticles
article_id
string
The unique identifier for the article.
free_gift_item_details
object
An object containing details about the free gift item.
parent_item_identifier
string
The identifier for the parent item to which this free article is related.
quantity
number
The quantity of the free article.
quantity
integer
The quantity of the item.
prices
object (Prices)
Prices
delivery_charge
number
The delivery charge for the order.
coupon_value
number
The value of the coupon applied.
brand_calculated_amount
number
The amount calculated by the brand.
value_of_good
number
The value of the goods before tax and other charges.
price_marked
number
The original marked price of the item.
coupon_effective_discount
number
The effective discount from coupons.
currency_symbol
string
The symbol of the currency used.
discount
number
The discount applied to the item.
gst_tax_percentage
number
The GST tax percentage applied.
cod_charges
number
The cash on delivery charges, if applicable.
amount_paid
number
The total amount paid by the customer.
added_to_fynd_cash
boolean
Indicates if the refund amount was added to Fynd Cash.
transfer_price
number
The transfer price of the item.
cashback_applied
number
The amount of cashback applied.
price_effective
number
The effective price after all adjustments.
cashback
number
The cashback amount earned.
refund_credit
number
The amount credited for refund .
amount_paid_roundoff
number
The rounded-off amount paid by the customer.
promotion_effective_discount
number
The effective discount from promotions.
refund_amount
number
The amount refunded to the customer.
currency_code
string
The code of the currency used.
fynd_credits
number
The amount of Fynd credits used.
amount_to_be_collected
number
The total amount that needs to be collected from the customer.
can_cancel
boolean
Indicates if the item can be canceled.
can_return
boolean
Indicates if the item can be returned.
id
integer
The unique identifier for the order item.
returnable_date
string
Nullable
The last date and time by which the item can be returned.
financial_breakup
array of object (FinancialBreakup)
An array containing financial details of the item.
Array of FinancialBreakup
coupon_value
number
The value of the coupon applied.
delivery_charge
number
The delivery charge for the order.
brand_calculated_amount
number
The amount calculated by the brand.
value_of_good
number
The value of the goods before tax and other charges.
price_marked
number
The original marked price of the item.
coupon_effective_discount
number
The effective discount from coupons.
hsn_code
string
The HSN (Harmonized System of Nomenclature) code of the item.
discount
number
The discount applied to the item.
gst_tax_percentage
number
The GST tax percentage applied .
cod_charges
number
The cash on delivery charges, if applicable.
amount_paid
number
The total amount paid by the customer.
added_to_fynd_cash
boolean
Indicates if the refund amount was added to Fynd Cash.
size
string
The size of the item .
transfer_price
number
The transfer price of the item.
cashback_applied
number
The amount of cashback applied.
price_effective
number
The effective price after all adjustments.
cashback
number
The cashback amount earned.
refund_credit
number
The amount credited for refund .
amount_paid_roundoff
number
The rounded-off amount paid by the customer.
total_units
integer
The total number of units purchased.
identifiers
object (Identifiers)
Identifiers
ean
string
The European Article Number (EAN) of the item.
sku_code
string
The Stock Keeping Unit (SKU) code of the item.
gst_tag
string
The GST tag indicating the type of GST applied.
item_name
string
The name of the item.
promotion_effective_discount
number
The effective discount from promotions.
gst_fee
number
The GST fee applied to the item.
refund_amount
number
The amount refunded to the customer.
fynd_credits
number
The amount of Fynd credits used.
amount_to_be_collected
number
The total amount that needs to be collected from the customer.
parent_promo_bags
object
An object containing details of parent promotional bags.
meta
object
An object containing metadata for the item.
currency_code
string
The code of the currency used.
seller_identifier
string
The identifier for the seller.
current_status
object (CurrentStatus)
CurrentStatus
updated_at
string
The date and time when the status was last updated.
name
string
The name or label indicating the current state or status.
status
string
The current status of the bag.
journey_type
string
Nullable
The type of journey for the shipment, indicating the direction of the shipment.
article
object (Article)
Nullable
Article
tags
array of string
An array of tags associated with the article.
dp_name
string
The name of the delivery partner.
awb_no
string
The airway bill number for the shipment.
beneficiary_details
boolean
Indicates if there are any beneficiary details.
fulfilling_company
object (FulfillingCompany)
FulfillingCompany
id
integer
The unique identifier for the fulfilling company.
name
string
The name of the fulfilling company.
can_return
boolean
Indicates if the shipment can be returned.
delivery_address
object (Address)
Address
pincode
string
The postal code of the address.
phone
string
The phone number of the person associated with the address.
latitude
number
Nullable
The latitude coordinate.
address2
string
The secondary line of the address.
landmark
string
A nearby landmark.
area
string
The area or locality.
city
string
The city of the address.
address
string
The full address.
address_type
string
The type of address.
longitude
number
Nullable
The longitude coordinate.
country_iso_code
string
The ISO code for the country.
state
string
The state of the address.
created_at
string
The date and time when the address was created.
address1
string
The primary line of the address.
display_address
string
The formatted display address, typically used for printing or displaying in user interfaces.
name
string
The name of the person associated with the address.
contact_person
string
The name of the contact person.
address_category
string
The category of the address.
email
string
The email address.
country_phone_code
string
The country phone code.
version
string
The version of the address format.
updated_at
string
The date and time when the address was last updated .
country
string
The country of the address.
billing_address
object (Address)
Address
pincode
string
The postal code of the address.
phone
string
The phone number of the person associated with the address.
latitude
number
Nullable
The latitude coordinate.
address2
string
The secondary line of the address.
landmark
string
A nearby landmark.
area
string
The area or locality.
city
string
The city of the address.
address
string
The full address.
address_type
string
The type of address.
longitude
number
Nullable
The longitude coordinate.
country_iso_code
string
The ISO code for the country.
state
string
The state of the address.
created_at
string
The date and time when the address was created.
address1
string
The primary line of the address.
display_address
string
The formatted display address, typically used for printing or displaying in user interfaces.
name
string
The name of the person associated with the address.
contact_person
string
The name of the contact person.
address_category
string
The category of the address.
email
string
The email address.
country_phone_code
string
The country phone code.
version
string
The version of the address format.
updated_at
string
The date and time when the address was last updated .
country
string
The country of the address.
track_url
string
The URL for tracking the shipment.
order_id
string
The unique identifier for the order.
need_help_url
string
The URL for customer support or help.
return_meta
object
An object containing metadata about the return process.
delivery_date
string
Nullable
The expected delivery date.
order
object (OrderRequest)
OrderRequest
meta
object
Metadata for the order.
bags_for_reorder
array of object (BagsForReorder)
An array containing details of bags available for reorder.
Array of BagsForReorder
item_size
string
The size of the item.
quantity
integer
The quantity of the item.
store_id
integer
The identifier for the store.
article_assignment
object (BagsForReorderArticleAssignment)
BagsForReorderArticleAssignment
strategy
string
The strategy used for article assignment.
level
string
The level at which the article assignment is made.
seller_id
integer
The identifier for the seller.
item_id
integer
The unique identifier for the item.
meta
object
An object containing additional metadata for the order.
filters
object (OrderFilters)
OrderFilters
statuses
array of object (OrderStatuses)
An array containing the order statuses.
Array of OrderStatuses
value
integer
The value representing the selection.
is_selected
boolean
Indicates whether this option is currently selected.
display
string
The text to display .
Examples
Parameters
status:
1
page_no:
1
page_size:
1
from_date:
"value"
to_date:
"value"
start_date:
"value"
end_date:
"value"
custom_meta:
"value"
allow_inactive:
false
GET
/service/application/order/v1.0/orders
Loading...
Response
Loading...
GET

Get an order

Get order details such as tracking details, shipment, store information using Fynd Order ID.
Parameters
order_id
string
Required
A unique number used for identifying and tracking an order.
allow_inactive
boolean
Flag to allow inactive shipments.
Default Value : false
Response
200
4XX
5XX
Success. Check the example shown below or refer `OrderById` for more details.
OrderById
order
object (OrderSchema)
OrderSchema
total_shipments_in_order
integer
The total number of shipments in the order.
gstin_code
string
The GSTIN code for the shipment.
user_info
object (UserInfo)
UserInfo
first_name
string
First name of the user.
gender
string
Gender of the user.
name
string
Full name of the user (including first and last names).
last_name
string
Last name of the user.
mobile
string
Mobile number of the user.
email
string
Email address of the user.
breakup_values
array of object (BreakupValues)
An array containing the breakup of various charges and discounts.
Array of BreakupValues
value
number
The numerical value associated with the entity.
currency_symbol
string
Symbol representing the currency used for the value.
name
string
The official name of the entity.
display
string
The name of the entity as it should be displayed.
currency_code
string
The international currency code representing the currency used for the value.
order_created_time
string
The date and time when the order was created.
order_created_ts
string
The timestamp when the order was created.
order_id
string
The unique identifier for the order.
shipments
array of object (Shipments)
An array containing details of individual shipments within the order.
Array of Shipments
payment
object (ShipmentPayment)
ShipmentPayment
mop
string
Abbreviation or code for the payment mode.
payment_mode
string
The specific payment mode used.
status
string
The current status of the payment.
mode
string
The payment mode.
logo
string
URL of the logo representing the payment mode.
display_name
string
The name to be displayed for the payment mode.
payment_info
array of object (ShipmentPaymentInfo)
Array of objects containing payment methods used for placing an order. Each object will provide information about corresponding payment method with relevant details.
Array of ShipmentPaymentInfo
mop
string
Stands for "Mode of Payment". This is a short code (like "COD" for Cash On Delivery) that represents the payment method used.
payment_mode
string
Information about the payment mode, indicates whether COD or PREPAID.
status
string
Indicates the current status of the payment, Paid or Unpaid.
mode
string
Information about the payment source. For eg, NB_ICICI.
logo
string
A URL to an image representing the payment method.
display_name
string
The name of the payment method as it should be displayed to the user.
amount
number
Amount paid using this payment method.
order_type
string
Nullable
The type of order.
gstin_code
string
The GSTIN code for the shipment.
show_download_invoice
boolean
Indicates if the download invoice option should be shown.
can_cancel
boolean
Indicates if the shipment can be canceled.
user_info
object (ShipmentUserInfo)
ShipmentUserInfo
first_name
string
The unique identifier of the store.
gender
string
A code associated with the store.
name
string
The name of the store.
last_name
string
The name of the company associated with the store.
mobile
string
The identifier of the company associated with the store.
email
string
Email address of the user.
shipment_id
string
The unique identifier for the shipment.
fulfilling_store
object (FulfillingStore)
FulfillingStore
id
integer
The unique identifier of the store.
code
string
A code associated with the store.
name
string
The name of the store.
company_name
string
The name of the company associated with the store.
company_id
integer
The identifier of the company associated with the store.
custom_meta
array of object
An object containing custom metadata for the shipment.
shipment_status
object (ShipmentStatus)
ShipmentStatus
value
string
Nullable
The internal or code value representing the shipment status.
title
string
The title or display name representing the shipment status.
hex_code
string
The hexadecimal color code associated with the shipment status.
comment
string
Any comments related to the shipment.
invoice
object (Invoice)
Invoice
invoice_url
string
URL providing access to the invoice.
updated_date
string
The date and time when the invoice was last updated.
label_url
string
URL providing access to the invoice label.
show_track_link
boolean
Indicates if the track link should be shown.
refund_details
object
An object containing details of any refunds.
breakup_values
array of object (BreakupValues)
An array containing the breakup of various charges and discounts.
Array of BreakupValues
value
number
The numerical value associated with the entity.
currency_symbol
string
Symbol representing the currency used for the value.
name
string
The official name of the entity.
display
string
The name of the entity as it should be displayed.
currency_code
string
The international currency code representing the currency used for the value.
can_break
object
An object containing details about the breakability of the shipment.
traking_no
string
The tracking number for the shipment.
tracking_details
array of object (TrackingDetails)
An array containing details of the tracking history of the shipment.
Array of TrackingDetails
value
string
Nullable
Current value or state of the process.
is_current
boolean
Indicates whether the tracking event is the current or active status.
is_passed
boolean
Indicates whether the tracking event has passed or occurred.
status
string
The status of the tracking event.
time
string
The time associated with the tracking event.
created_ts
string
Timestamp when this status was created.
tracking_details
array of object (NestedTrackingDetails)
Nested tracking details.
Array of NestedTrackingDetails
is_passed
boolean
Indicates whether the tracking event has passed or occurred.
time
string
The time associated with the tracking event.
is_current
boolean
Indicates whether the tracking event is the current or active status.
status
string
The status of the tracking event.
promise
object (Promise)
Promise
show_promise
boolean
Indicates whether the promise details should be shown.
timestamp
object (TimeStampData)
TimeStampData
min
string
The minimum timestamp value.
max
string
The maximum timestamp value.
total_bags
integer
The total number of bags in the shipment.
total_details
object (ShipmentTotalDetails)
ShipmentTotalDetails
pieces
integer
The total number of pieces included.
total_price
number
The total price of the order or item.
sizes
integer
The number of different sizes included.
prices
object (Prices)
Prices
delivery_charge
number
The delivery charge for the order.
coupon_value
number
The value of the coupon applied.
brand_calculated_amount
number
The amount calculated by the brand.
value_of_good
number
The value of the goods before tax and other charges.
price_marked
number
The original marked price of the item.
coupon_effective_discount
number
The effective discount from coupons.
currency_symbol
string
The symbol of the currency used.
discount
number
The discount applied to the item.
gst_tax_percentage
number
The GST tax percentage applied.
cod_charges
number
The cash on delivery charges, if applicable.
amount_paid
number
The total amount paid by the customer.
added_to_fynd_cash
boolean
Indicates if the refund amount was added to Fynd Cash.
transfer_price
number
The transfer price of the item.
cashback_applied
number
The amount of cashback applied.
price_effective
number
The effective price after all adjustments.
cashback
number
The cashback amount earned.
refund_credit
number
The amount credited for refund .
amount_paid_roundoff
number
The rounded-off amount paid by the customer.
promotion_effective_discount
number
The effective discount from promotions.
refund_amount
number
The amount refunded to the customer.
currency_code
string
The code of the currency used.
fynd_credits
number
The amount of Fynd credits used.
amount_to_be_collected
number
The total amount that needs to be collected from the customer.
returnable_date
string
Nullable
The last date by which the item can be returned.
shipment_created_at
string
The date and time when the shipment was created.
shipment_created_ts
string
The timestamp when the shipment was created.
size_info
object
An object containing size information for the items in the shipment.
bags
array of object (Bags)
An array containing details about the individual bags in the shipment.
Array of Bags
delivery_date
string
Nullable
The date and time when the item is expected to be delivered .
line_number
integer
The line number of the item in the order.
currency_symbol
string
The symbol of the currency used.
item
object (Item)
Item
image
array of string
An array of URLs pointing to images of the item.
l1_categories
array of string
An array of level 1 categories to which the item belongs.
l2_category
array of string
An array of level 2 categories to which the item belongs.
l2_category_id
number
ID representing the level 2 category classification of the item
brand
object (ItemBrand)
ItemBrand
logo
string
The URL of the brand's logo.
name
string
The name of the brand.
seller_identifier
string
The identifier for the seller .
code
string
The code or SKU of the item.
id
number
The unique identifier of the item.
name
string
The name of the item.
l3_category_name
string
The level 3 category name.
slug_key
string
A unique key or identifier for the item slug.
l2_categories
array of string
An array of level 2 categories the item belongs to.
size
string
The size of the item.
attributes
object
An object containing various attributes of the item.
applied_promos
array of object (AppliedPromos)
An array containing information about applied promotions.
Array of AppliedPromos
mrp_promotion
boolean
Indicates if the promotion is applied to the MRP.
promotion_name
string
The name of the promotion .
article_quantity
number
The quantity of articles required to qualify for the promotion.
promo_id
string
The unique identifier for the promotion.
amount
number
The discount amount provided by the promotion.
promotion_type
string
The type of promotion.
applied_free_articles
array of object (AppliedFreeArticles)
An array containing details of free articles applied under the promotion.
Array of AppliedFreeArticles
article_id
string
The unique identifier for the article.
free_gift_item_details
object
An object containing details about the free gift item.
parent_item_identifier
string
The identifier for the parent item to which this free article is related.
quantity
number
The quantity of the free article.
quantity
integer
The quantity of the item.
prices
object (Prices)
Prices
delivery_charge
number
The delivery charge for the order.
coupon_value
number
The value of the coupon applied.
brand_calculated_amount
number
The amount calculated by the brand.
value_of_good
number
The value of the goods before tax and other charges.
price_marked
number
The original marked price of the item.
coupon_effective_discount
number
The effective discount from coupons.
currency_symbol
string
The symbol of the currency used.
discount
number
The discount applied to the item.
gst_tax_percentage
number
The GST tax percentage applied.
cod_charges
number
The cash on delivery charges, if applicable.
amount_paid
number
The total amount paid by the customer.
added_to_fynd_cash
boolean
Indicates if the refund amount was added to Fynd Cash.
transfer_price
number
The transfer price of the item.
cashback_applied
number
The amount of cashback applied.
price_effective
number
The effective price after all adjustments.
cashback
number
The cashback amount earned.
refund_credit
number
The amount credited for refund .
amount_paid_roundoff
number
The rounded-off amount paid by the customer.
promotion_effective_discount
number
The effective discount from promotions.
refund_amount
number
The amount refunded to the customer.
currency_code
string
The code of the currency used.
fynd_credits
number
The amount of Fynd credits used.
amount_to_be_collected
number
The total amount that needs to be collected from the customer.
can_cancel
boolean
Indicates if the item can be canceled.
can_return
boolean
Indicates if the item can be returned.
id
integer
The unique identifier for the order item.
returnable_date
string
Nullable
The last date and time by which the item can be returned.
financial_breakup
array of object (FinancialBreakup)
An array containing financial details of the item.
Array of FinancialBreakup
coupon_value
number
The value of the coupon applied.
delivery_charge
number
The delivery charge for the order.
brand_calculated_amount
number
The amount calculated by the brand.
value_of_good
number
The value of the goods before tax and other charges.
price_marked
number
The original marked price of the item.
coupon_effective_discount
number
The effective discount from coupons.
hsn_code
string
The HSN (Harmonized System of Nomenclature) code of the item.
discount
number
The discount applied to the item.
gst_tax_percentage
number
The GST tax percentage applied .
cod_charges
number
The cash on delivery charges, if applicable.
amount_paid
number
The total amount paid by the customer.
added_to_fynd_cash
boolean
Indicates if the refund amount was added to Fynd Cash.
size
string
The size of the item .
transfer_price
number
The transfer price of the item.
cashback_applied
number
The amount of cashback applied.
price_effective
number
The effective price after all adjustments.
cashback
number
The cashback amount earned.
refund_credit
number
The amount credited for refund .
amount_paid_roundoff
number
The rounded-off amount paid by the customer.
total_units
integer
The total number of units purchased.
identifiers
object (Identifiers)
Identifiers
ean
string
The European Article Number (EAN) of the item.
sku_code
string
The Stock Keeping Unit (SKU) code of the item.
gst_tag
string
The GST tag indicating the type of GST applied.
item_name
string
The name of the item.
promotion_effective_discount
number
The effective discount from promotions.
gst_fee
number
The GST fee applied to the item.
refund_amount
number
The amount refunded to the customer.
fynd_credits
number
The amount of Fynd credits used.
amount_to_be_collected
number
The total amount that needs to be collected from the customer.
parent_promo_bags
object
An object containing details of parent promotional bags.
meta
object
An object containing metadata for the item.
currency_code
string
The code of the currency used.
seller_identifier
string
The identifier for the seller.
current_status
object (CurrentStatus)
CurrentStatus
updated_at
string
The date and time when the status was last updated.
name
string
The name or label indicating the current state or status.
status
string
The current status of the bag.
journey_type
string
Nullable
The type of journey for the shipment, indicating the direction of the shipment.
article
object (Article)
Nullable
Article
tags
array of string
An array of tags associated with the article.
dp_name
string
The name of the delivery partner.
awb_no
string
The airway bill number for the shipment.
beneficiary_details
boolean
Indicates if there are any beneficiary details.
fulfilling_company
object (FulfillingCompany)
FulfillingCompany
id
integer
The unique identifier for the fulfilling company.
name
string
The name of the fulfilling company.
can_return
boolean
Indicates if the shipment can be returned.
delivery_address
object (Address)
Address
pincode
string
The postal code of the address.
phone
string
The phone number of the person associated with the address.
latitude
number
Nullable
The latitude coordinate.
address2
string
The secondary line of the address.
landmark
string
A nearby landmark.
area
string
The area or locality.
city
string
The city of the address.
address
string
The full address.
address_type
string
The type of address.
longitude
number
Nullable
The longitude coordinate.
country_iso_code
string
The ISO code for the country.
state
string
The state of the address.
created_at
string
The date and time when the address was created.
address1
string
The primary line of the address.
display_address
string
The formatted display address, typically used for printing or displaying in user interfaces.
name
string
The name of the person associated with the address.
contact_person
string
The name of the contact person.
address_category
string
The category of the address.
email
string
The email address.
country_phone_code
string
The country phone code.
version
string
The version of the address format.
updated_at
string
The date and time when the address was last updated .
country
string
The country of the address.
billing_address
object (Address)
Address
pincode
string
The postal code of the address.
phone
string
The phone number of the person associated with the address.
latitude
number
Nullable
The latitude coordinate.
address2
string
The secondary line of the address.
landmark
string
A nearby landmark.
area
string
The area or locality.
city
string
The city of the address.
address
string
The full address.
address_type
string
The type of address.
longitude
number
Nullable
The longitude coordinate.
country_iso_code
string
The ISO code for the country.
state
string
The state of the address.
created_at
string
The date and time when the address was created.
address1
string
The primary line of the address.
display_address
string
The formatted display address, typically used for printing or displaying in user interfaces.
name
string
The name of the person associated with the address.
contact_person
string
The name of the contact person.
address_category
string
The category of the address.
email
string
The email address.
country_phone_code
string
The country phone code.
version
string
The version of the address format.
updated_at
string
The date and time when the address was last updated .
country
string
The country of the address.
track_url
string
The URL for tracking the shipment.
order_id
string
The unique identifier for the order.
need_help_url
string
The URL for customer support or help.
return_meta
object
An object containing metadata about the return process.
delivery_date
string
Nullable
The expected delivery date.
order
object (OrderRequest)
OrderRequest
meta
object
Metadata for the order.
bags_for_reorder
array of object (BagsForReorder)
An array containing details of bags available for reorder.
Array of BagsForReorder
item_size
string
The size of the item.
quantity
integer
The quantity of the item.
store_id
integer
The identifier for the store.
article_assignment
object (BagsForReorderArticleAssignment)
BagsForReorderArticleAssignment
strategy
string
The strategy used for article assignment.
level
string
The level at which the article assignment is made.
seller_id
integer
The identifier for the seller.
item_id
integer
The unique identifier for the item.
meta
object
An object containing additional metadata for the order.
Examples
Parameters
order_id:
"value"
allow_inactive:
false
GET
/service/application/order/v1.0/orders/{order_id}
Loading...
Response
Loading...

Shipment

Shipment represents the physical movement of goods from the seller (or your warehouse) to the customer. It's associated with a specific order and includes details like tracking information, carrier used, weight, dimensions, and estimated delivery date. An Order can contain multiple shipments. Shipments are created based on multiple factors like selling location assigned to that shipment, the packaging material available etc. A shipment will get created whenever there is a partial transition of items also when there is a negative state transition is invoked. Negative state transition can be defined against a state. Currently only some defined states are configured as negative. If any state is to be added as negative state then please contact support team.

Operations
GET
/service/application/order/v1.0/orders/shipments/{shipment_id}
# Get a Shipment
GET
/service/application/order/v1.0/orders/shipments/{shipment_id}/invoice
# Retrieves invoice for shipment
GET
/service/application/order/v1.0/orders/shipments/{shipment_id}/track
# Track shipment status
GET
/service/application/order/v1.0/orders/{order_id}/shipments/{shipment_id}/customer-details
# Get shipment's customer
POST
/service/application/order/v1.0/orders/{order_id}/shipments/{shipment_id}/otp/send/
# Send OTP to customer
POST
/service/application/order/v1.0/orders/{order_id}/shipments/{shipment_id}/otp/verify/
# Verifies OTP
GET
/service/application/order/v1.0/orders/shipments/{shipment_id}/reasons
# List shipment cancellation reasons
PUT
/service/application/order/v1.0/orders/shipments/{shipment_id}/status
# Updates shipment status
GET

Get a Shipment

Get shipment details such as price breakup, tracking details, store information, etc. using Shipment ID.
Parameters
shipment_id
string
Required
ID of the shipment. An order may contain multiple items and may get divided into one or more shipment, each having its own ID.
allow_inactive
boolean
Flag to allow inactive shipments.
Default Value : false
Response
200
4XX
5XX
Success. Check the example shown below or refer `ShipmentById` for more details.
ShipmentById
shipment
object (Shipments)
Shipments
payment
object (ShipmentPayment)
ShipmentPayment
mop
string
Abbreviation or code for the payment mode.
payment_mode
string
The specific payment mode used.
status
string
The current status of the payment.
mode
string
The payment mode.
logo
string
URL of the logo representing the payment mode.
display_name
string
The name to be displayed for the payment mode.
payment_info
array of object (ShipmentPaymentInfo)
Array of objects containing payment methods used for placing an order. Each object will provide information about corresponding payment method with relevant details.
Array of ShipmentPaymentInfo
mop
string
Stands for "Mode of Payment". This is a short code (like "COD" for Cash On Delivery) that represents the payment method used.
payment_mode
string
Information about the payment mode, indicates whether COD or PREPAID.
status
string
Indicates the current status of the payment, Paid or Unpaid.
mode
string
Information about the payment source. For eg, NB_ICICI.
logo
string
A URL to an image representing the payment method.
display_name
string
The name of the payment method as it should be displayed to the user.
amount
number
Amount paid using this payment method.
order_type
string
Nullable
The type of order.
gstin_code
string
The GSTIN code for the shipment.
show_download_invoice
boolean
Indicates if the download invoice option should be shown.
can_cancel
boolean
Indicates if the shipment can be canceled.
user_info
object (ShipmentUserInfo)
ShipmentUserInfo
first_name
string
The unique identifier of the store.
gender
string
A code associated with the store.
name
string
The name of the store.
last_name
string
The name of the company associated with the store.
mobile
string
The identifier of the company associated with the store.
email
string
Email address of the user.
shipment_id
string
The unique identifier for the shipment.
fulfilling_store
object (FulfillingStore)
FulfillingStore
id
integer
The unique identifier of the store.
code
string
A code associated with the store.
name
string
The name of the store.
company_name
string
The name of the company associated with the store.
company_id
integer
The identifier of the company associated with the store.
custom_meta
array of object
An object containing custom metadata for the shipment.
shipment_status
object (ShipmentStatus)
ShipmentStatus
value
string
Nullable
The internal or code value representing the shipment status.
title
string
The title or display name representing the shipment status.
hex_code
string
The hexadecimal color code associated with the shipment status.
comment
string
Any comments related to the shipment.
invoice
object (Invoice)
Invoice
invoice_url
string
URL providing access to the invoice.
updated_date
string
The date and time when the invoice was last updated.
label_url
string
URL providing access to the invoice label.
show_track_link
boolean
Indicates if the track link should be shown.
refund_details
object
An object containing details of any refunds.
breakup_values
array of object (BreakupValues)
An array containing the breakup of various charges and discounts.
Array of BreakupValues
value
number
The numerical value associated with the entity.
currency_symbol
string
Symbol representing the currency used for the value.
name
string
The official name of the entity.
display
string
The name of the entity as it should be displayed.
currency_code
string
The international currency code representing the currency used for the value.
can_break
object
An object containing details about the breakability of the shipment.
traking_no
string
The tracking number for the shipment.
tracking_details
array of object (TrackingDetails)
An array containing details of the tracking history of the shipment.
Array of TrackingDetails
value
string
Nullable
Current value or state of the process.
is_current
boolean
Indicates whether the tracking event is the current or active status.
is_passed
boolean
Indicates whether the tracking event has passed or occurred.
status
string
The status of the tracking event.
time
string
The time associated with the tracking event.
created_ts
string
Timestamp when this status was created.
tracking_details
array of object (NestedTrackingDetails)
Nested tracking details.
Array of NestedTrackingDetails
is_passed
boolean
Indicates whether the tracking event has passed or occurred.
time
string
The time associated with the tracking event.
is_current
boolean
Indicates whether the tracking event is the current or active status.
status
string
The status of the tracking event.
promise
object (Promise)
Promise
show_promise
boolean
Indicates whether the promise details should be shown.
timestamp
object (TimeStampData)
TimeStampData
min
string
The minimum timestamp value.
max
string
The maximum timestamp value.
total_bags
integer
The total number of bags in the shipment.
total_details
object (ShipmentTotalDetails)
ShipmentTotalDetails
pieces
integer
The total number of pieces included.
total_price
number
The total price of the order or item.
sizes
integer
The number of different sizes included.
prices
object (Prices)
Prices
delivery_charge
number
The delivery charge for the order.
coupon_value
number
The value of the coupon applied.
brand_calculated_amount
number
The amount calculated by the brand.
value_of_good
number
The value of the goods before tax and other charges.
price_marked
number
The original marked price of the item.
coupon_effective_discount
number
The effective discount from coupons.
currency_symbol
string
The symbol of the currency used.
discount
number
The discount applied to the item.
gst_tax_percentage
number
The GST tax percentage applied.
cod_charges
number
The cash on delivery charges, if applicable.
amount_paid
number
The total amount paid by the customer.
added_to_fynd_cash
boolean
Indicates if the refund amount was added to Fynd Cash.
transfer_price
number
The transfer price of the item.
cashback_applied
number
The amount of cashback applied.
price_effective
number
The effective price after all adjustments.
cashback
number
The cashback amount earned.
refund_credit
number
The amount credited for refund .
amount_paid_roundoff
number
The rounded-off amount paid by the customer.
promotion_effective_discount
number
The effective discount from promotions.
refund_amount
number
The amount refunded to the customer.
currency_code
string
The code of the currency used.
fynd_credits
number
The amount of Fynd credits used.
amount_to_be_collected
number
The total amount that needs to be collected from the customer.
returnable_date
string
Nullable
The last date by which the item can be returned.
shipment_created_at
string
The date and time when the shipment was created.
shipment_created_ts
string
The timestamp when the shipment was created.
size_info
object
An object containing size information for the items in the shipment.
bags
array of object (Bags)
An array containing details about the individual bags in the shipment.
Array of Bags
delivery_date
string
Nullable
The date and time when the item is expected to be delivered .
line_number
integer
The line number of the item in the order.
currency_symbol
string
The symbol of the currency used.
item
object (Item)
Item
image
array of string
An array of URLs pointing to images of the item.
l1_categories
array of string
An array of level 1 categories to which the item belongs.
l2_category
array of string
An array of level 2 categories to which the item belongs.
l2_category_id
number
ID representing the level 2 category classification of the item
brand
object (ItemBrand)
ItemBrand
logo
string
The URL of the brand's logo.
name
string
The name of the brand.
seller_identifier
string
The identifier for the seller .
code
string
The code or SKU of the item.
id
number
The unique identifier of the item.
name
string
The name of the item.
l3_category_name
string
The level 3 category name.
slug_key
string
A unique key or identifier for the item slug.
l2_categories
array of string
An array of level 2 categories the item belongs to.
size
string
The size of the item.
attributes
object
An object containing various attributes of the item.
applied_promos
array of object (AppliedPromos)
An array containing information about applied promotions.
Array of AppliedPromos
mrp_promotion
boolean
Indicates if the promotion is applied to the MRP.
promotion_name
string
The name of the promotion .
article_quantity
number
The quantity of articles required to qualify for the promotion.
promo_id
string
The unique identifier for the promotion.
amount
number
The discount amount provided by the promotion.
promotion_type
string
The type of promotion.
applied_free_articles
array of object (AppliedFreeArticles)
An array containing details of free articles applied under the promotion.
Array of AppliedFreeArticles
article_id
string
The unique identifier for the article.
free_gift_item_details
object
An object containing details about the free gift item.
parent_item_identifier
string
The identifier for the parent item to which this free article is related.
quantity
number
The quantity of the free article.
quantity
integer
The quantity of the item.
prices
object (Prices)
Prices
delivery_charge
number
The delivery charge for the order.
coupon_value
number
The value of the coupon applied.
brand_calculated_amount
number
The amount calculated by the brand.
value_of_good
number
The value of the goods before tax and other charges.
price_marked
number
The original marked price of the item.
coupon_effective_discount
number
The effective discount from coupons.
currency_symbol
string
The symbol of the currency used.
discount
number
The discount applied to the item.
gst_tax_percentage
number
The GST tax percentage applied.
cod_charges
number
The cash on delivery charges, if applicable.
amount_paid
number
The total amount paid by the customer.
added_to_fynd_cash
boolean
Indicates if the refund amount was added to Fynd Cash.
transfer_price
number
The transfer price of the item.
cashback_applied
number
The amount of cashback applied.
price_effective
number
The effective price after all adjustments.
cashback
number
The cashback amount earned.
refund_credit
number
The amount credited for refund .
amount_paid_roundoff
number
The rounded-off amount paid by the customer.
promotion_effective_discount
number
The effective discount from promotions.
refund_amount
number
The amount refunded to the customer.
currency_code
string
The code of the currency used.
fynd_credits
number
The amount of Fynd credits used.
amount_to_be_collected
number
The total amount that needs to be collected from the customer.
can_cancel
boolean
Indicates if the item can be canceled.
can_return
boolean
Indicates if the item can be returned.
id
integer
The unique identifier for the order item.
returnable_date
string
Nullable
The last date and time by which the item can be returned.
financial_breakup
array of object (FinancialBreakup)
An array containing financial details of the item.
Array of FinancialBreakup
coupon_value
number
The value of the coupon applied.
delivery_charge
number
The delivery charge for the order.
brand_calculated_amount
number
The amount calculated by the brand.
value_of_good
number
The value of the goods before tax and other charges.
price_marked
number
The original marked price of the item.
coupon_effective_discount
number
The effective discount from coupons.
hsn_code
string
The HSN (Harmonized System of Nomenclature) code of the item.
discount
number
The discount applied to the item.
gst_tax_percentage
number
The GST tax percentage applied .
cod_charges
number
The cash on delivery charges, if applicable.
amount_paid
number
The total amount paid by the customer.
added_to_fynd_cash
boolean
Indicates if the refund amount was added to Fynd Cash.
size
string
The size of the item .
transfer_price
number
The transfer price of the item.
cashback_applied
number
The amount of cashback applied.
price_effective
number
The effective price after all adjustments.
cashback
number
The cashback amount earned.
refund_credit
number
The amount credited for refund .
amount_paid_roundoff
number
The rounded-off amount paid by the customer.
total_units
integer
The total number of units purchased.
identifiers
object (Identifiers)
Identifiers
ean
string
The European Article Number (EAN) of the item.
sku_code
string
The Stock Keeping Unit (SKU) code of the item.
gst_tag
string
The GST tag indicating the type of GST applied.
item_name
string
The name of the item.
promotion_effective_discount
number
The effective discount from promotions.
gst_fee
number
The GST fee applied to the item.
refund_amount
number
The amount refunded to the customer.
fynd_credits
number
The amount of Fynd credits used.
amount_to_be_collected
number
The total amount that needs to be collected from the customer.
parent_promo_bags
object
An object containing details of parent promotional bags.
meta
object
An object containing metadata for the item.
currency_code
string
The code of the currency used.
seller_identifier
string
The identifier for the seller.
current_status
object (CurrentStatus)
CurrentStatus
updated_at
string
The date and time when the status was last updated.
name
string
The name or label indicating the current state or status.
status
string
The current status of the bag.
journey_type
string
Nullable
The type of journey for the shipment, indicating the direction of the shipment.
article
object (Article)
Nullable
Article
tags
array of string
An array of tags associated with the article.
dp_name
string
The name of the delivery partner.
awb_no
string
The airway bill number for the shipment.
beneficiary_details
boolean
Indicates if there are any beneficiary details.
fulfilling_company
object (FulfillingCompany)
FulfillingCompany
id
integer
The unique identifier for the fulfilling company.
name
string
The name of the fulfilling company.
can_return
boolean
Indicates if the shipment can be returned.
delivery_address
object (Address)
Address
pincode
string
The postal code of the address.
phone
string
The phone number of the person associated with the address.
latitude
number
Nullable
The latitude coordinate.
address2
string
The secondary line of the address.
landmark
string
A nearby landmark.
area
string
The area or locality.
city
string
The city of the address.
address
string
The full address.
address_type
string
The type of address.
longitude
number
Nullable
The longitude coordinate.
country_iso_code
string
The ISO code for the country.
state
string
The state of the address.
created_at
string
The date and time when the address was created.
address1
string
The primary line of the address.
display_address
string
The formatted display address, typically used for printing or displaying in user interfaces.
name
string
The name of the person associated with the address.
contact_person
string
The name of the contact person.
address_category
string
The category of the address.
email
string
The email address.
country_phone_code
string
The country phone code.
version
string
The version of the address format.
updated_at
string
The date and time when the address was last updated .
country
string
The country of the address.
billing_address
object (Address)
Address
pincode
string
The postal code of the address.
phone
string
The phone number of the person associated with the address.
latitude
number
Nullable
The latitude coordinate.
address2
string
The secondary line of the address.
landmark
string
A nearby landmark.
area
string
The area or locality.
city
string
The city of the address.
address
string
The full address.
address_type
string
The type of address.
longitude
number
Nullable
The longitude coordinate.
country_iso_code
string
The ISO code for the country.
state
string
The state of the address.
created_at
string
The date and time when the address was created.
address1
string
The primary line of the address.
display_address
string
The formatted display address, typically used for printing or displaying in user interfaces.
name
string
The name of the person associated with the address.
contact_person
string
The name of the contact person.
address_category
string
The category of the address.
email
string
The email address.
country_phone_code
string
The country phone code.
version
string
The version of the address format.
updated_at
string
The date and time when the address was last updated .
country
string
The country of the address.
track_url
string
The URL for tracking the shipment.
order_id
string
The unique identifier for the order.
need_help_url
string
The URL for customer support or help.
return_meta
object
An object containing metadata about the return process.
delivery_date
string
Nullable
The expected delivery date.
order
object (OrderRequest)
OrderRequest
meta
object
Metadata for the order.
Examples
Parameters
shipment_id:
"value"
allow_inactive:
false
GET
/service/application/order/v1.0/orders/shipments/{shipment_id}
Loading...
Response
Loading...
GET

Retrieves invoice for shipment

Get invoice corresponding to a specific shipment ID.
Parameters
shipment_id
string
Required
ID of the shipment.
Response
200
4XX
5XX
Success. Check the example shown below or refer `ShipmentById` for more details.
ResponseGetInvoiceShipment
presigned_type
string
Type of presigned URL.
success
boolean
Indicates if the operation was successful .
shipment_id
string
Identifier for the shipment.
presigned_url
string
The presigned URL for accessing the shipment data, obtained from the response data.
Examples
Parameters
shipment_id:
"value"
GET
/service/application/order/v1.0/orders/shipments/{shipment_id}/invoice
Loading...
Response
Loading...
GET

Track shipment status

Track Shipment by shipment id, for application based on application Id.
Parameters
shipment_id
string
Required
ID of the shipment. An order may contain multiple items and may get divided into one or more shipment, each having its own ID.
Default Value : 16544950215681060915J
Response
200
4XX
5XX
Success. Check the example shown below or refer `ShipmentTrack` for more details.
ShipmentTrack
results
array of object (Track)
A array containing tracking details.
Array of Track
account_name
string
The name of the account handling the shipment.
shipment_type
string
The type of shipment.
status
string
The current status of the shipment.
last_location_recieved_at
string
The last known location of the shipment.
updated_time
string
The timestamp of the last update.
updated_at
string
The date and time when the shipment was last updated.
reason
string
The reason or additional information about the shipment.
awb
string
The Air Waybill (AWB) number for the shipment.
Examples
Parameters
shipment_id:
"value"
GET
/service/application/order/v1.0/orders/shipments/{shipment_id}/track
Loading...
Response
Loading...
GET

Get shipment's customer

Get customer details such as mobile number using Shipment ID.
Parameters
order_id
string
Required
A unique number used for identifying and tracking your orders.
Default Value : 16544950215681060915J
shipment_id
string
Required
ID of the shipment. An order may contain multiple items and may get divided into one or more shipment, each having its own ID.
Default Value : FY6299E19701B4EAEFC2
Response
200
4XX
5XX
Success. Check the example shown below or refer `CustomerDetailsByShipmentId` for more details.
CustomerDetailsResponse
phone
string
Customer's phone number.
shipment_id
string
Unique identifier of the shipment.
name
string
Customer's name.
order_id
string
Unique identifier of the order.
country
string
Country of the customer.
Examples
Parameters
order_id:
"value"
shipment_id:
"value"
GET
/service/application/order/v1.0/orders/{order_id}/shipments/{shipment_id}/customer-details
Loading...
Response
Loading...
POST

Send OTP to customer

Send OTP to the customer for shipment verification.
Parameters
order_id
string
Required
A unique number used for identifying and tracking your orders.
Default Value : FY6299E19701B4EAEFC2
shipment_id
string
Required
ID of the shipment. An order may contain multiple items and may get divided into one or more shipment, each having its own ID.
Default Value : 16544950215681060915J
Response
200
4XX
5XX
Success to acknowledge the service was notified
SendOtpToCustomerResponse
request_id
string
Unique identifier for the request.
message
string
Message indicating the result of the request.
success
boolean
Indicates whether the request was successful.
resend_timer
integer
Time in seconds before the OTP can be resent.
Examples
Parameters
order_id:
"value"
shipment_id:
"value"
POST
/service/application/order/v1.0/orders/{order_id}/shipments/{shipment_id}/otp/send/
Loading...
Response
Loading...
POST

Verifies OTP

Verify OTP sent by customer.
Parameters
order_id
string
Required
A unique number used for identifying and tracking your orders.
Default Value : FYMP6294545C010B89FD
shipment_id
string
Required
ID of the shipment. An order may contain multiple items and may get divided into one or more shipment, each having its own ID.
Default Value : 16538880933361957252J
Request body
otp_code
string
The OTP code provided by the user for verification.
request_id
string
Unique identifier for the request.
Response
200
4XX
5XX
Success, the code is valid and returns a session token
VerifyOtpResponse
success
boolean
Indicates whether the request was successful.
Examples
Parameters
order_id:
"value"
shipment_id:
"value"
body:
body
POST
/service/application/order/v1.0/orders/{order_id}/shipments/{shipment_id}/otp/verify/
Loading...
Response
Loading...
GET

List shipment cancellation reasons

Get reasons to perform full or partial cancellation of a shipment.
Parameters
shipment_id
string
Required
ID of the shipment. An order may contain multiple items and may get divided into one or more shipment, each having its own ID.
Response
200
4XX
5XX
Success. Check the example shown below or refer `ShipmentBagReasons` for more details.
ShipmentReasons
reasons
array of object (ShipmentReason)
A list of shipment reasons.
Array of ShipmentReason
priority
integer
The priority level of the reason.
show_text_area
boolean
A flag indicating whether to show a textbox on the frontend.
reason_id
integer
The unique identifier for the reason.
feedback_type
string
The type of feedback.
reason_text
string
The text describing the reason.
flow
string
The process flow related to the reason.
Examples
Parameters
shipment_id:
"value"
GET
/service/application/order/v1.0/orders/shipments/{shipment_id}/reasons
Loading...
Response
Loading...
PUT

Updates shipment status

Update current status of a specific shipment using its shipment ID. Supports both partial and full transition as per the configured settings.
Parameters
shipment_id
string
Required
ID of the shipment. An order may contain multiple items and may get divided into one or more shipment, each having its own ID.
Request body
statuses
array of object (StatuesRequest)
An array containing different status details.
Array of StatuesRequest
shipments
array of object (ShipmentsRequest)
A list containing information about shipments.
Array of ShipmentsRequest
reasons
object (ReasonsData)
ReasonsData
products
array of object (ProductsReasons)
Reasons data for bags.
Array of ProductsReasons
data
object (ProductsReasonsData)
ProductsReasonsData
reason_id
integer
The unique identifier for the reason.
reason_text
string
The text describing the reason.
filters
array of object (ProductsReasonsFilters)
Criteria applied to filter the products.
Array of ProductsReasonsFilters
line_number
integer
The specific line item of bag.
quantity
integer
The quantity of the product.
identifier
string
The unique identifier for the product.
entities
array of object (EntitiesReasons)
Reasons data for shipments.
Array of EntitiesReasons
data
object (EntityReasonData)
EntityReasonData
reason_id
integer
The unique identifier for the reason.
reason_text
string
The text describing the reason.
filters
array of object
Criteria applied to filter the shipment.
products
array of object (Products)
Specific bag to be updated.
Array of Products
line_number
integer
The specific line item of bag.
quantity
integer
The quantity of the product.
identifier
string
The unique identifier for the product.
data_updates
object (DataUpdates)
DataUpdates
products
array of object (ProductsDataUpdates)
Data updates for bags.
Array of ProductsDataUpdates
data
object
Information about the data to be updated.
filters
array of object (ProductsDataUpdatesFilters)
Criteria applied to filter the products.
Array of ProductsDataUpdatesFilters
line_number
integer
The specific line item of bag.
identifier
string
The quantity of the product.
entities
array of object (EntitiesDataUpdates)
Data updates for shipments.
Array of EntitiesDataUpdates
data
object
Information about the data to be updated.
filters
array of object
Criteria applied to filter the shipments.
identifier
string
Required
The unique identifier for request which is the shipment_id.
exclude_bags_next_state
string
State to be change for Remaining Bag/Products.
status
string
The status to which the entity is to be transitioned.
task
boolean
Indicates whether the task is active or required.
lock_after_transition
boolean
Indicates whether the status should be locked after the transition.
force_transition
boolean
Indicates whether the transition should be forced.
unlock_before_transition
boolean
Indicates whether the status should be unlocked before the transition.
Response
200
4XX
5XX
Successfully updateShipmentStatus!
ShipmentApplicationStatusResponse
statuses
array of object (StatusesBodyResponse)
An array containing different status options of shipments.
Array of StatusesBodyResponse
shipments
array of object
List of shipments.
Examples
Parameters
shipment_id:
"value"
body:
body
PUT
/service/application/order/v1.0/orders/shipments/{shipment_id}/status
Loading...
Response
Loading...