.. _orderItemIdsList-label:

GET /orders/
-------------

**Description** - The Get by OrderItemIds API gets order item details for multiple order items based on the specified ``orderItemIds``.

Request and Response Parameters
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: toggle

    .. container:: header

        **☰ SHOW | HIDE**

    **URL:** ``https://api.flipkart.net/sellers/v2/orders/?orderItemIds={id1,id2,...}``

    **Request Header Parameters**

    +----------------+------------+----------------------------------------+
    |Parameter       |Requirement | Description                            |
    +================+============+========================================+
    |``orderItemIds``|Mandatory   |Comma separated list of ``orderItemIds``|
    +----------------+------------+----------------------------------------+

    **Validations** ::

        Maximum 100 orderItemIds per request.

    **Response Body Parameters:**

    +--------------------------------------+---------------+-------------------------------------------+
    |Parameter/Attribute/Field             |Type           |  Description                              |
    +======================================+===============+===========================================+
    |``orderItemId``                       |String         |The primary identifier for seller actions  |
    |                                      |               |for an order item and associated attributes|
    +--------------------------------------+---------------+-------------------------------------------+
    |``orderId``                           |String         |System generated order ID for the buyer    |
    +--------------------------------------+---------------+-------------------------------------------+
    |``status``                            |String         |The current order processing status.       |
    |                                      |               |Possible values: ``APPROVED``,             |
    |                                      |               |``PACKING_IN_PROGRESS``, ``PACKED``,       | 
    |                                      |               |``READY_TO_DISPATCH``, ``PICKUP_COMPLETE``,| 
    |                                      |               |``CANCELLED``, ``SHIPPED``, ``DELIVERED``, | 
    |                                      |               |``RETURN_REQUESTED``, ``RETURNED``         |
    +--------------------------------------+---------------+-------------------------------------------+
    |``hold``                              |Boolean        |Flag (true or false) for order verification|
    |                                      |               |process                                    |
    +--------------------------------------+---------------+-------------------------------------------+
    |``orderDate``                         |ISO String     |Date on which the order was placed         |
    +--------------------------------------+---------------+-------------------------------------------+
    |``dispatchAfterDate``                 |ISO String     |Date after which the order items needs to  |
    |                                      |               |processed by the seller                    |
    +--------------------------------------+---------------+-------------------------------------------+
    |``dispatchByDate``                    |ISO String     |Date by which the order items needs to be  |
    |                                      |               |dispatched by the seller                   |
    +--------------------------------------+---------------+-------------------------------------------+
    |``sla``                               |Integer        |Allowed SLA for this order item            |
    +--------------------------------------+---------------+-------------------------------------------+
    |``quantity``                          |Integer        |Number of units ordered for this order item|
    +--------------------------------------+---------------+-------------------------------------------+
    |``title``                             |String         |Product listing title                      |
    +--------------------------------------+---------------+-------------------------------------------+
    |``listingId``                         |String         |Product listing ID                         |
    +--------------------------------------+---------------+-------------------------------------------+
    |``fsn``                               |String         |Flipkart product identifier                |
    +--------------------------------------+---------------+-------------------------------------------+
    |``sku``                               |String         |Seller SKU for the listing                 |
    +--------------------------------------+---------------+-------------------------------------------+
    |``price``                             |Integer        |Total price of the order item              |
    |                                      |               |**Note:** To be deprecated soon            |
    +--------------------------------------+---------------+-------------------------------------------+
    |``shippingFee``                       |Float          |Shipping charge per unit                   |
    |                                      |               |**Note:** To be deprecated soon            |
    +--------------------------------------+---------------+-------------------------------------------+
    |``shippingPinCode``                   |String         |Postal address pin code                    |
    +--------------------------------------+---------------+-------------------------------------------+
    |``stateDocuments``                    |List<String>   |List of state documents to be attached with|
    |                                      |               |the shipment                               |
    +--------------------------------------+---------------+-------------------------------------------+
    |``subItems``                          |List<orderItem>|Freebies associated with the order item.   |
    |                                      |               |**Note:** Freebies must be shipped along   | 
    |                                      |               |with the primary order item                |
    +--------------------------------------+---------------+-------------------------------------------+

    **Possible Error Response Codes**

        ================================  =========================
        Error Codes                       Reason for Error
        ================================  =========================
        ``DEPENDENT_SYSTEM_CALL_FAILED``  Error in getting order details.
        ``UNPROCESSABLE_ENTITY``          When more than processable orderItemIds are received.
        ================================  =========================

|

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

|