.. _getVendorDetails-label:

GET /v3/shipments/handover/counts?locationId={location_id}
---------------------------------------------------------

**Description** - The get vendor details api gives number of shipments belong to particular vendor. It gives number of shipments in RTD state.

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

.. container:: toggle

    .. container:: header

        **☰ SHOW | HIDE**

    **URL:** ``https://api.flipkart.net/sellers/v3/shipments/handover/counts?locationId={location_id}``

    **Request Header Parameters**

    +-----------------+-------------+------------------------------------------------+
    | Path Parameter  | Requirement | Description                                    |
    +=================+=============+================================================+
    | ``locationId``  | Mandatory   | Id which refers to seller's dispatch location  |
    +-----------------+-------------+------------------------------------------------+

    **Response Body Parameters**

    +----------------------------+------------+----------------------------------------------------------------+
    | Parameter/Attribute        | Type       | Description                                                    |
    +============================+============+================================================================+
    | ``vendorGroupCode``        | String     | Vendor code to which dispatchable shipments belong             |
    +----------------------------+------------+----------------------------------------------------------------+
    | ``isMps``                  | Boolean    | Are shipments belong to Multi pack shipment                    |
    +----------------------------+------------+----------------------------------------------------------------+
    | ``count``                  | Integer    | Number of dispatchable shipments for that vendor               |
    +----------------------------+------------+----------------------------------------------------------------+
    | ``otc``. ``code``          | String     | A One Time Code, that is to be shared with pickup executive,   |
    |                            |            | at the time of handing over / receiving the shipments.         |
    +----------------------------+------------+----------------------------------------------------------------+
    | ``otc``. ``error_code``    | String     | Error details if any, when the OTC code is not available.      |
    |                            |            | Possible Values-                                               |
    |                            |            | ``OTC_UNAVAILABLE`` - OTC not generated yet. Please retry after|
    |                            |            | a while.                                                       |
    +----------------------------+------------+----------------------------------------------------------------+
    | ``pickUpDate``. ``after``  | ISO String | Date time after pick up will be made by the particular vendor  |
    +----------------------------+------------+----------------------------------------------------------------+
    | ``pickUpDate``. ``before`` | ISO String | Date time before pick up will be made by the particular vendor |
    +----------------------------+------------+----------------------------------------------------------------+

    **Possible Error Response Codes**

    ================================  =========================
    Error Codes                       Reason for Error
    ================================  =========================
    ``DEPENDENT_SYSTEM_CALL_FAILED``  This error occurs if an internal system fails during get vendor details call
    ================================  =========================

|

`Try it out! <https://sandbox-api.flipkart.net/swagger/#/Shipment%20V3/getVendorGroupDetails>`_
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

|