Fetch Orders

Use the Fetch Orders endpoint to retrieve shipments based on their current status, with the option to filter by date ranges, order IDs, ordering channels, and location codes.

Request Type: GET
Scheme: HTTPS
Endpoint: https://{{host}}/oms/v3/shipment

Try out Fynd Konnect's Fetch Orders Endpoint

Common Request Header

Header	Mandatory	Description
`x-access-token`	Yes	Access token used for authenticating API requests to Fynd Konnect.

Best Practices

Schedule periodic fetches to capture orders or returns from Fynd OMS. For industry-recommended Cron Polling Intervals, refer to our Best Practices section

Query

orderingChannelstring

Filter shipments by the sales channel (e.g., FYND, JIOMART, ECOMM, etc.)

orderStatusstringrequired

Filters orders by current status (CREATED, CONFIRMED, PROCESSING, etc.)

pageNumberinteger

Page number for paginated results

pageSizeinteger

Number of results per page

locationCodestring

Store or warehouse location code. If using Company-level auth, locationCode is mandatory

orderDateFromstring(date)

Filters orders from this date (dd-mm-yyyy)

orderDateTostring(date)

Filters orders up to this date (dd-mm-yyyy)

Want to fetch better results?

Use query parameters like orderStatus, pageNumber, and locationCode (only required in the case of company-level auth) to refine the results.

Success Resposne

idstring

Unique identifier for the shipment or order

forwardIdstring

Forward ID if this is a return, else same as shipment id

marketplaceOrderIdstring

Marketplace-provided order ID if applicable

shippingAddressobject

orderItemsArray of objects(OrderItem)

orderStatusstring

Current status of the entire order

orderDatestring(date-time)

Timestamp when the order was placed

orderingChannelstring

Sales channel like FYND, JIOMART, ECOMM, etc.

API Call Example

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/oms/v3/shipment?locationCode=string&orderDateFrom=2019-08-24&orderDateTo=2019-08-24&orderId=string&orderStatus=string&orderingChannel=string&pageNumber=0&pageSize=0' \
  -H 'x-access-token: YOUR_API_KEY_HERE'

Response

application/json

[
  {
    "id": "17328629784861446350",
    "forwardId": "17328629784861446350",
    "marketplaceOrderId": "FY674964020E8E174561",
    "marketplaceReturnId": null,
    "marketplaceInvoiceNumber": null,
    "shippingAddress": { … },
    "billingAddress": { … },
    "multiPackShipment": false,
    "packages": [ … ],
    "fulfillmentType": "marketplaceFulfilled",
    "sellerInvoiced": false,
    "courierName": "Fynd-Test",
    "courierCode": "Fynd-Test",
    "awbNumber": [],
    "additionalInfo": "You can add additional info here",
    "orderPrice": { … },
    "orderItems": [ … ],
    "orderStatus": "DELIVERED",
    "orderDate": "2025-01-25T12:19:38+00:00",
    "modifiedDate": "2025-01-30T12:21:04",
    "paymentType": "COD",
    "taxExempted": false,
    "gstin": null,
    "packAfterDate": null,
    "packByDate": null,
    "pickUpSlots": [],
    "orderingChannel": "Konnect Test",
    "labelPdfUrl": null,
    "purchaseOrderPdfUrl": null,
    "invoiceNumber": null,
    "returnInvoiceNumber": null,
    "irnNumber": null,
    "invoiceQrCode": null,
    "signedInvoice": null,
    "orderBusinessType": "B2C",
    "lockStatus": false,
    "fulfillmentPriority": null,
    "journeyType": "forward",
    "cformProvided": false,
    "A4invoicePdfUrl": null,
    "A6invoicePdfUrl": "https://storage.googleapis.com/fynd-staging-assets-private/...",
    "is_returnless": false,
    "is_self_ship": true
  }
]

Supported Ordering Channels

Below are the orderingChannel values supported by Fynd Konnect. They reflect different marketplace or sales channels from which the orders originate.

Channel	Overview and Usage
`FYND-STORE`	Covers orders placed via the merchant's Fynd Store OS storefront.
`FYND`	Channel orders placed directly via GoFynd's online platform.
`ECOMM`	Indicates e-commerce orders placed on Fynd Commerce. Often used for standard web store sales.
`AMAZON_MLF`	Used for Amazon Multi-Location Fulfillment orders. Suitable if a brand leverages Amazon's warehousing but still wants to track orders in Fynd OMS.
`MYNTRA_IN`	Integrates orders from Myntra India's fashion marketplace.
`UNIKET`	Uniket is a B2B footwear marketplace owned by Fynd. Typical for sellers focusing on wholesale or large-scale distribution.
`TATACLIQ_IN`	Orders from Tata CLiQ; an Indian e-commerce by Tata Group.
`FLIPKARTASSURED`	A specialized subset of Flipkart (F-Assured) orders marked for high quality and quick deliveries.
`AJIO_VMS`	Reflects orders from AJIO. Channel used for multi-brand apparel or lifestyle segments.
`TATACLIQ_LUXURY`	Signifies premium or luxury items via Tata CLiQ's upscale segment.
`NYKAA_FASHION`	Orders from the Nykaa Fashion marketplace (apparel and accessories).
`NYKAA`	Standard Nykaa e-commerce platform, typically cosmetics and lifestyle products.
`TRELL`	Social commerce platform Trell, often lifestyle or influencer-driven.
`MAGICPIN`	Magicpin, a local discovery and rewards-based commerce solution which joined the ONDC platform for localized food delivery.
`SHOPIFY_IN`	Identifies orders from Shopify India webstores.
`FLIPKART`	General Flipkart channel orders.
`JIOMART`	Reliance Retail's JioMart (grocery and general e-commerce).
`FY_NEXUS`	Reserved for sellers selling through Nexus Malls expansions.

Order Status

By specifying the orderStatus query parameter, you can filter orders based on their lifecycle stage within Fynd OMS.

Status	Description
`CREATED`	Newly placed orders on Fynd. Typically in the `placed` or `store_reassigned` state in the Fynd OMS.
`CONFIRMED`	Shipments where all items are in `bag_confirmed` in Fynd OMS. Ready for further actions like invoicing and courier assignment.
`PROCESSING`	Orders in `bag_invoiced` or `dp_assigned` state in Fynd OMS. Typically post-confirmation, pre-dispatch.
`COMPLETED`	Order fulfillment is complete. Orders in `bag_packed` or `bag_not_picked` states on Fynd OMS.
`TRANSIT`	Order en route to customer. Orders in `bag_picked` states on Fynd OMS.
`HANDED_OVER_TO_CUSTOMER`	Goods delivered in-person or picked up at the store by the customer. Orders in `handed_over_to_customer` state on Fynd OMS.
`DELIVERED`	Orders successfully delivered at the customer address. Orders in `delivery_done` state on Fynd OMS.
`RETURN_PROCESSING`	Return or RTO process initiated, but not yet delivered back to the seller. Returns in `return_initiated` or `return_dp_assigned` states on Fynd.
`RETURN_DELIVERED`	Fetches customer returns (bag in `return_bag_delivered` on Fynd) or RTO bags (bag in `rto_bag_delivered` on Fynd) delivered to the seller warehouse.
`RETURN_COMPLETED`	A return or RTO accepted by the seller after QC.
`CANCELLED`	Order (either partially or complete) canceled by user, Fynd, or the seller.
`CREDIT_NOTE_GENERATED`	Credit note generation post return completion.

Next Steps

To fetch an order by its shipment ID, see Order by ID.
To fetch customer returns, see Returns
For bulk cancellations or partial item cancellations, see Order Cancellation.
To confirm the order, see Order Confirmation