# 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
br
**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](/konnect/channels/erp-wms/best-practices/cron-timings) section

### Query

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

### API Call Example

## 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 StoreOS storefront.

 |
| `FYND` | - Channel orders placed directly via GoFynd's online platform.

 |
| `ECOMM` | - Indicates seller website orders placed on Fynd Commerce.

 |
| `AMAZON_MLF` | - Indicates 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 247 marketplace.

 |


### 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](/konnect/channels/erp-wms/api-documentation/orders/get-order-by-id).
* To fetch customer returns, see [Returns](/konnect/channels/erp-wms/api-documentation/returns/get-returns)
* For bulk cancellations or partial item cancellations, see [Order Cancellation](/konnect/channels/erp-wms/api-documentation/orders/post-order-cancellation).
* To confirm the order, see [Order Confirmation](/konnect/channels/erp-wms/api-documentation/orders/post-order-confirmation)