.. _get-listings-label:

**GET** /listings/v3/``{sku-ids}``
----------------------------------

Summary:
   Retrieve the information listed against the provided SKU Ids.

Description:
   This call fetches the information listed against the specified SKUs. If the SKU does not exist in the system, then it will be identified in the ``unavailable`` field in the response.

   The authorization header is mandatory to access this API along with all other Flipkart Seller APIs.

Input:
  .. container:: toggle

    .. container:: header

        ☰ Toggle

    **Request parameter descriptions**

    +-----------+--------+------------+--------------------------------------------------------+
    | Parameter | Type   | Occurrence | Description                                            |
    +===========+========+============+========================================================+
    | sku-ids   | String | Mandatory  | Comma-separated list of SKU Ids. Maximum per call: 10. |
    +-----------+--------+------------+--------------------------------------------------------+

Output:
  .. container:: toggle

    .. container:: header

        ☰ Toggle

    **Response Headers**

    +--------------+---------------------------------+
    | Header       | Meaning                         |
    +==============+=================================+
    | Content-Type | application/json; charset=utf-8 |
    +--------------+---------------------------------+

    **Status Codes**

    This call may return the HTTP status codes defined in the table below.

    +--------+----------------------+
    | Status | Interpretation       |
    +========+======================+
    | 200    | Success.             |
    +--------+----------------------+
    | 400    | Bad Request          |
    +--------+----------------------+
    | 500    | Internal Server      |
    |        | Error                |
    +--------+----------------------+

    **Payload Model**

    1. 200 OK
      .. literalinclude:: v3/payloads/GetListingResponse.json
          :linenos:
          :language: json
    2. 400 Bad Request
      .. literalinclude:: v3/payloads/ClientErrorResponse.json
          :linenos:
          :language: json
    3. 500 Bad Request
      .. literalinclude:: v3/payloads/ServerErrorResponse.json
          :linenos:
          :language: json

    **Response field descriptions**

    +-------------+------+-------------+-----------------------------------------------------------------------------------+
    | Field       | Type | Occurrence  | Description                                                                       |
    +=============+======+=============+===================================================================================+
    | available   | Map  | Conditional | Holds the listing information for the requested SKU Ids.                          |
    +-------------+------+-------------+-----------------------------------------------------------------------------------+
    | unavailable | List | Conditional | The list of SKU Ids for which listing information could not be retrieved.         |
    +-------------+------+-------------+-----------------------------------------------------------------------------------+
    | invalid     | List | Conditional | The list of SKU Ids which are invalid according to the contracts' specifications. |
    +-------------+------+-------------+-----------------------------------------------------------------------------------+