==========================
GET /:country/listings/map
==========================

Returns a map for partner's listing IDs (source_id) mapped to corresponding
Opendi listing IDs (opendi_id). If the optional ``source_id``  URL parameter is
set, the mappings will be returned only for that ID.

This request is limited to a maximum of 1000 entries.

Parameters
----------

.. list-table::
    :header-rows: 1
    :widths: 20 80

    * - | Key
      - | Value
    * - | **source_id**
        | *Optional*
      - | Partner's unique listing ID to filter by. May contain alphanumeric characters and the following symbols: ``-``, ``_``, and ``*``.
        |
        | Asterisk (*) is treated as a wildcard.

Responses
---------

On success returns **HTTP 200 OK** with the folowing data:

============= ==================================================================
 Key           Content / Description
============= ==================================================================
 numFound      The number of mappings matching the given ``source_id``
 numReturned   The number of mappings returned, can be less than ``numFound``.
 mappings      An array of `Mappings`_ (can be empty).
============= ==================================================================

On error returns an `Error`_ object.

Examples
--------

**GET https://api.opendi.com/de/listings/map?source_id=1234**

``HTTP 200 OK``

.. code-block:: javascript

    {
        "numFound": 1,
        "numReturned": 1,
        "results": [
            {
                "source_id": "1234",
                "opendi_id": "678865"
            }
        ]
    }

**GET https://api.opendi.com/de/listings/map?source_id=warendorf%2A**

``HTTP 200 OK``

.. code-block:: javascript

    {
        "numFound": 2,
        "numReturned": 2,
        "results": [
            {
                "source_id": "warendorf-1234333",
                "opendi_id": "678865"
            },
            {
                "source_id": "warendorf-1234234",
                "opendi_id": "678866"
            }
        ]
    }

.. _Mapping: ./../models.html#mapping
.. _Mappings: ./../models.html#mapping
.. _Error: ./../models.html#error