mobile.de API Manual

https://services.mobile.de/manual/
Admin
Documentation for mobile.de's APIs, including Seller-API, Search-API, Ad-Stream, and Insights-API,...
Tokens:162,647
Snippets:1,185
Trust Score:9.7
Update:3 months ago
Show doc for...
Tokens:
Raw
### Fetch single ad request example

Source: https://services.mobile.de/manual/search-api.html

Example of a GET request to retrieve an ad by its unique key. Ensure the Accept header is set to one of the supported XML or JSON media types.

```http
GET /search-api/ad/456 HTTP/1.0
Host: services.mobile.de
Accept: application/xml
```

--------------------------------

### Get Lead Updates Response

Source: https://services.mobile.de/manual/lead-api.html

Example JSON response containing a list of lead events and a nextCursor for pagination.

```JSON
HTTP/1.1 200 OK

{
  "version": "2025-04-16",
  "traceId": "tx-id-1",
  "nextCursor": "MjAyNC0wMS0wMVQxMjowMDowMFo6zLTk4YWVkLTc2ZWUYWEwMw==",
  "events": [
{
      "occurredAt": "2025-06-30T14:18:36+02:00",
      "eventId": "0197c0c6-6231-7cad-96ab-25ef2a24f1ce",
      "eventType": "MessagingLeadResubmitted",
      "leadId": "lead-2",
      "data": {
        "message": {
          "text": "Hi there, please contact me via this phone number instead."
        },
        "potentialBuyer": {
          "name": "Maria Mustermann",
          "firstName": "Maria",
          "lastName": "Mustermann",
          "email": "maria@test.com",
          "phone": {
            "internationalPrefix": 49,
            "number": "123456789"
          },
          "buyerIdentifier": "ed84c73ac1dd7e062c71df6ec05a315265b12dfd6d0"
        },
        "source": "MOBILE",
        "vehicle": {
          "mobileAdId": "1241451",
          "make": "BMW",
          "model": "i3",
          "conditionType": "USED",
          "type": "PKW",
          "customerNumber": "154152",
          "internalNumber": "1234",
          "firstRegistration": "2022-11",
          "mileage": 144022,
          "price": "13000"
        }
      }
    },
    {
      "occurredAt": "2025-06-30T12:18:36.209Z",
      "eventId": "0197c0c6-6231-7cad-96ab-25ef2a24f1cf",
      "eventType": "BuyerReplied",
      "leadId": "lead-1",
      "data": {
        "message": {
          "text": "Hi there, please tell me more"
        },
        "potentialBuyer": {},
        "source": "MOBILE"
      }
    },
    {
      "occurredAt": "2025-06-30T14:18:36+02:00",
      "eventId": "0197c0c6-6231-7cad-96ab-25ef2a24f1ce",
      "eventType": "MessagingLeadSubmitted",
      "leadId": "lead-2",
      "data": {
        "message": {
          "text": "Hi there, this is an initial submission"
        },
        "potentialBuyer": {
          "name": "Maria Mustermann",
          "firstName": "Maria",
          "lastName": "Mustermann",
          "email": "maria@test.com",
          "phone": {
            "internationalPrefix": 49,
            "number": "1823953021"
          },
          "buyerIdentifier": "ed84c73ac1dd7e062c71df6ec05a315265b12dfd6d0"
        },
        "source": "MOBILE",
        "vehicle": {
          "mobileAdId": "1241451",
          "make": "BMW",
          "model": "i3",
          "conditionType": "USED",
          "type": "PKW",
          "customerNumber": "154152",
          "internalNumber": "1234",
          "firstRegistration": "2022-11",
          "mileage": 144022,
          "price": "13000"
        }
      }
    },
    {
      "occurredAt": "2025-06-30T15:30:22+02:00",
      "eventId": "0197c0c6-7845-8dbe-a7bc-36fg3b35g2df",
      "eventType": "BuyerSearchBehaviourAdded",
      "leadId": "lead-2",
      "data": {
        "makeModels": [
          {
            "make": "BMW",
            "model": "3 Series"
          },
          {
            "make": "Audi",
            "model": "A4"
          }
        ],
        "fuelTypes": [
          {
            "value": "DIESEL"
          },
          {
            "value": "HYBRID"
          }
        ],
        "gearTypes": [
          {
            "value": "AUTOMATIC_GEAR"
          }

```

--------------------------------

### Vehicle Description Formatting Example

Source: https://services.mobile.de/manual/formatting-syntax.html

A complete example showing how to combine various formatting commands within a CSV or XML description field.

```text
The vehicle has the following additional features:\\
* Winter tires Warranty\\
* Warranty\\
* **Automatic climate control**\\
---- \\
We also provide the following services:\\
** * Insurance\\
* Financing\\**
Call us!
```

--------------------------------

### Get Lead Updates Request

Source: https://services.mobile.de/manual/lead-api.html

Example request for fetching lead events for a specific seller using a cursor.

```HTTP
GET /lead-api/sellers/12/events?cursor=MjAyNC0wMS0wMVQxMjowMDowMFo6zLTk1YWItNzhhZC04YWVkLTc2ZWUxNTY3YWEwMw
Host: services.mobile.de
```

--------------------------------

### IN_PROGRESS Response Example

Source: https://services.mobile.de/manual/new-seller-api.html

Example of a JSON response when the quality score calculation is still in progress.

```json
{
    "mobileAdId": "251471",
    "mobileSellerId": "20085",
    "creationDate": "2025-10-31T13:59:33+01:00",
    "modificationDate": "2025-11-04T15:00:34+01:00",
    "status": "IN_PROGRESS",
    "imageQuality": {
        "images": [
            {
              "baseUrl": "img.classistatic.de/api/v1/mo-nonprod/images/83/839b5c93-2c20-4983-a1ad-39721c8c4e74",
              "status": "IN_PROGRESS"
            }
        ]
    },
    "imageQuantity": {
        "score": 0,
        "optimal": 25,
        "min": 10,
        "current": 1
    },
    "descriptionLength": {
        "score": 60,
        "optimal": 1000,
        "min": 500,
        "current": 800
    },
    "attributeCoverage": {
        "score": 41,
        "optimal": 22,
        "current": 9,
        "attributes": {
            "covered": [
                "modelDescription",
                "condition",
                "deliveryPeriod",
                "modelRange",
                "model",
                "fuel",
                "trimLine",
                "category",
                "make"
            ],
            "missing": [
                "cylinder",
                "cubicCapacity",
                "climatisation",
                "power",
                "exteriorColor",
                "interiorType",
                "airbag",
                "emissionSticker",
                "doors",
                "gearbox",
                "emissionClass",
                "parkingAssistants",
                "seats"
            ]
        }
    }
}
```

--------------------------------

### Sample XML Event

Source: https://services.mobile.de/manual/ad-stream.html

Example of an AD_CREATE_OR_UPDATE event in the legacy XML format.

```xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<search:event xmlns:seller="http://services.mobile.de/schema/seller"
              xmlns:search="http://services.mobile.de/schema/search"
              xmlns:ad="http://services.mobile.de/schema/ad"
              xmlns:resource="http://services.mobile.de/schema/resource"
              xmlns:financing="http://services.mobile.de/schema/common/financing-1.0"
              xmlns:error="http://services.mobile.de/schema/common/error-1.0">
    <search:event-type>AD_CREATE_OR_UPDATE</search:event-type>
    <search:ad-key>152229071</search:ad-key>
    <ad:ad key="152229071" url="https://services.mobile.de/search-api/ad/152229071">
        <ad:creation-date value="2017-10-18T09:26:40+02:00"/>
        <ad:modification-date value="2017-10-18T09:26:42+02:00"/>
        <ad:detail-page url="https://suchen.mobile.de/auto-inserat/mercedes-benz-vito-116cdi-l-klima-tempomat-sitzheizung-pts-kevelaer/152229071.html"/>
        <ad:seller-inventory-key value="NFZ708645HND02"/>
        <ad:vehicle>
            <ad:class key="Car" url="https://services.mobile.de/refdata/classes/Car"/>
            <ad:category key="Van" url="https://services.mobile.de/refdata/classes/Car/categories/Van"/>
            <ad:make key="MERCEDES-BENZ" url="https://services.mobile.de/refdata/classes/Car/makes/MERCEDES-BENZ"/>
            <ad:model key="Vito" url="https://services.mobile.de/refdata/classes/Car/makes/MERCEDES-BENZ/models/Vito"/>
            <ad:model-description value="Vito 116CDI L *Klima*Tempomat*Sitzheizung*PTS*"/>
            <ad:damage-and-unrepaired value="false"/>
            <ad:features>
                <ad:feature key="CENTRAL_LOCKING" url="https://services.mobile.de/refdata/classes/Car/features/CENTRAL_LOCKING"/>
                <ad:feature key="ELECTRIC_WINDOWS" url="https://services.mobile.de/refdata/classes/Car/features/ELECTRIC_WINDOWS"/>
                <ad:feature key="IMMOBILIZER" url="https://services.mobile.de/refdata/classes/Car/features/IMMOBILIZER"/>
                <ad:feature key="POWER_ASSISTED_STEERING" url="https://services.mobile.de/refdata/classes/Car/features/POWER_ASSISTED_STEERING"/>
                <ad:feature key="ABS" url="https://services.mobile.de/refdata/classes/Car/features/ABS"/>
                <ad:feature key="ESP" url="https://services.mobile.de/refdata/classes/Car/features/ESP"/>
                <ad:feature key="FULL_SERVICE_HISTORY" url="https://services.mobile.de/refdata/classes/Car/features/FULL_SERVICE_HISTORY"/>
                <ad:feature key="CRUISE_CONTROL" url="https://services.mobile.de/refdata/classes/Car/features/CRUISE_CONTROL"/>
                <ad:feature key="PARKING_SENSORS" url="https://services.mobile.de/refdata/classes/Car/features/PARKING_SENSORS"/>
                <ad:feature key="ELECTRIC_HEATED_SEATS" url="https://services.mobile.de/refdata/classes/Car/features/ELECTRIC_HEATED_SEATS"/>
                <ad:feature key="PARTICULATE_FILTER_DIESEL" url="https://services.mobile.de/refdata/classes/Car/features/PARTICULATE_FILTER_DIESEL"/>
                <ad:feature key="HU_AU_NEU" url="https://services.mobile.de/refdata/classes/Car/features/HU_AU_NEU"/>
                <ad:feature key="WARRANTY" url="https://services.mobile.de/refdata/classes/Car/features/WARRANTY"/>
                <ad:feature key="AUTOMATIC_RAIN_SENSOR" url="https://services.mobile.de/refdata/classes/Car/features/AUTOMATIC_RAIN_SENSOR"/>
                <ad:feature key="BLUETOOTH" url="https://services.mobile.de/refdata/classes/Car/features/BLUETOOTH"/>
                <ad:feature key="ON_BOARD_COMPUTER" url="https://services.mobile.de/refdata/classes/Car/features/ON_BOARD_COMPUTER"/>
                <ad:feature key="HANDS_FREE_PHONE_SYSTEM" url="https://services.mobile.de/refdata/classes/Car/features/HANDS_FREE_PHONE_SYSTEM"/>
                <ad:feature key="MULTIFUNCTIONAL_WHEEL" url="https://services.mobile.de/refdata/classes/Car/features/MULTIFUNCTIONAL_WHEEL"/>
                <ad:feature key="TUNER" url="https://services.mobile.de/refdata/classes/Car/features/TUNER"/>
                <ad:feature key="TRACTION_CONTROL_SYSTEM" url="https://services.mobile.de/refdata/classes/Car/features/TRACTION_CONTROL_SYSTEM"/>
                <ad:feature key="ROOF_RAILS" url="https://services.mobile.de/refdata/classes/Car/features/ROOF_RAILS"/>
            </ad:features>
            <ad:specifics>
                <ad:exterior-color key="WHITE" url="https://services.mobile.de/refdata/colors/WHITE">
                    <ad:manufacturer-color-name value="arktikweiß"/>
                </ad:exterior-color>
                <ad:mileage value="41562"/>
```

--------------------------------

### Ad-Stream JSON and XML field examples

Source: https://services.mobile.de/manual/changelog.html

Examples showing the structure of the daytimeRunningLights field in JSON and XML formats.

```json
            {
                ...
                 "daytimeRunningLights": true,
                ...
            }
```

```xml
            <ad>
                ...
                 <daytimeRunningLights>true</daytimeRunningLights>
                ...
            </ad>
```

--------------------------------

### XML Seller Request and Response

Source: https://services.mobile.de/manual/new-seller-api.html

Example of a GET request for a seller using XML and the corresponding XML response structure.

```http
GET /seller-api/sellers/12 HTTP/1.1
Accept: application/vnd.de.mobile.api+xml
```

```xml
<?xml version="1.0" encoding="UTF-8"?>
<seller>
  <mobileSellerId>12</mobileSellerId>
  <customerNumber>8</customerNumber>
  <type>DEALER</type>
  <siteId>GERMANY</siteId>
  <readonly>false</readonly>
  <settings>
    <maxImages>15</maxImages>
    <maxHighlights>3</maxHighlights>
    <usedCarSeals>
        <value>VW</value>
        <value>AUDI</value>
    </usedCarSeals>
    <automatedExports>
        <automatedExport>
            <marketplace>ebay-kleinanzeigen.de</marketplace>
            <eligible>true</eligible>
            <active>false</active>
         </automatedExport>
    </automatedExports>
    <videoUrl>true</videoUrl>
  </settings>
  <companyName>Smoke AG</companyName>
</seller>
```

--------------------------------

### Retrieve a single seller request

Source: https://services.mobile.de/manual/seller-api-legacy.html

Example of a GET request to fetch seller details using a specific seller key.

```HTTP
GET /seller-api/sellers/123 HTTP/1.0
Host: services.mobile.de
X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf
Accept: application/vnd.de.mobile.seller-v2.0+xml
```

--------------------------------

### LeasingLeadSubmitted cURL Request

Source: https://services.mobile.de/manual/lead-api.html

Example request for submitting a new leasing lead.

```bash
curl -X POST "https://services.sandbox.mobile.de/lead-api/sellers/123456/sandbox/initial-submission-leasing" \
     -H 'Authorization: Basic dGVzdC1stttWWW123==' # Base64 encoded string
```

--------------------------------

### JSON Seller Request and Response

Source: https://services.mobile.de/manual/new-seller-api.html

Example of a GET request for a seller using JSON and the corresponding JSON response structure.

```http
GET /seller-api/sellers/12 HTTP/1.1
Accept: application/vnd.de.mobile.api+json
```

```json
{
    "mobileSellerId": "12",
    "customerNumber": "8",
    "type": "DEALER",
    "siteId": "GERMANY",
    "readonly": false,
    "settings": {
        "maxImages": 30,
        "maxHighlights": 3,
        "usedCarSeals": [
            "VW",
            "AUDI"
        ],
        "automatedExports" : [
            {
                "eligible" : true,
                "marketplace" : "ebay-kleinanzeigen.de",
                "active" : false
            }
        ],
        "videoUrl" : true
    },
    "companyName": "Smoke AG"
}
```

--------------------------------

### BuyerPreferencesUpdated cURL Request

Source: https://services.mobile.de/manual/lead-api.html

Example request for updating buyer preferences.

```bash
curl -X POST "https://services.sandbox.mobile.de/lead-api/sellers/123456/sandbox/buyer-preferences?leadId=LEAD123" \
     -H 'Authorization: Basic dGVzdC1stttWWW123==' # Base64 encoded string
```

--------------------------------

### GET /refdata/sites

Source: https://services.mobile.de/manual/reference-data.html

Retrieves a list of available sites.

```APIDOC
## GET /refdata/sites

### Description
Retrieves a list of available sites for the reference data service.

### Method
GET

### Endpoint
https://services.mobile.de/refdata/sites

### Parameters
#### Header Parameters
- **Accept** (string) - Required - Must be 'application/xml'.
- **Accept-Language** (string) - Optional - Language code (cz, de, en, es, fr, it, pl, ro, ru).
- **Accept-Encoding** (string) - Optional - Set to 'gzip' for compressed output.
```

--------------------------------

### Sample JSON Event Structure

Source: https://services.mobile.de/manual/ad-stream.html

Example of an AD_CREATE_OR_UPDATE event represented in JSON format.

```json
{
  "type": "AD_CREATE_OR_UPDATE",
  "mobileAdId": "474944",
  "ad": {
    "mobileAdId": "474944",
    "mobileSellerId": "15",
    "creationDate": "2018-04-10T15:29:21+02:00",
    "modificationDate": "2018-04-13T12:36:18+02:00",
    "vehicleClass": "Car",
    "category": "EstateCar",
    "make": "OPEL",
    "model": "Astra",
    "modelDescription": "Astra",
    "condition": "USED",
    "firstRegistration": "201301",
    "mileage": 123456,
    "cubicCapacity": 1984,
    "power": 108,
    "gearbox": "MANUAL_GEAR",
    "fuel": "PETROL",
    "e10Enabled": true,
    "performanceHandlingSystem": true,
    "startStopSystem": true,
    "envkvCompliant": false,
    "energyEfficiencyClass": "A+",
    "co2": 175,
    "consumptionInner": 10.2,
    "consumptionOuter": 5.9,
    "consumptionCombined": 7.5,
    "consumptionUnit": "LITER",
    "envkvPetrolType": "SUPER",
    "emissionSticker": "EMISSIONSSTICKER_GREEN",
    "exteriorColor": "BLACK",
    "metallic": true,
    "doors": "FOUR_OR_FIVE",
    "seats": 5,
    "interiorColor": "BLACK",
    "interiorType": "LEATHER",
    "generalInspection": "201801",
    "constructionDate": "2011-05-01T00:00:00+02:00",
    "numberOfPreviousOwners": 1,
    "fullServiceHistory": true,
    "nonSmokerVehicle": true,
    "countryVersion": "DE",
    "damageUnrepaired": false,
    "accidentDamaged": false,
    "roadworthy": true,
    "abs": true,
    "airbag": "FRONT_AND_SIDE_AND_MORE_AIRBAGS",
    "airSuspension": true,
    "alloyWheels": true,
    "automaticRainSensor": true,
    "auxiliaryHeating": true,
    "bendingLights": true,
    "bluetooth": true,
    "cdPlayer": true,
    "centralLocking": true,
    "disabledAccessible": true,
    "electricAdjustableSeats": true,
    "electricExteriorMirrors": true,
    "electricHeatedSeats": true,
    "electricWindows": true,
    "esp": true,
    "frontFogLights": true,
    "handsFreePhoneSystem": true,
    "headUpDisplay": true,
    "immobilizer": true,
    "isofix": true,
    "lightSensor": true,
    "multifunctionalWheel": true,
    "navigationSystem": true,
    "onBoardComputer": true,
    "panoramicGlassRoof": true,
    "parkingAssistants": [
      "CAM_360_DEGREES"
    ],
    "speedControl": "CRUISE_CONTROL",
    "radio": [
      "DAB_RADIO"
    ],
    "daytimeRunningLamps": "LED_RUNNING_LIGHTS",
    "slidingDoorType": "SLIDING_DOOR_RIGHT",
    "headlightType": "LED_HEADLIGHTS",
    "bendingLightsType": "BENDING_LIGHTS",
    "breakdownService": "SPARE_WHEEL",
    "battery": "BATTERY_RENTED",
    "trailerCouplingType": "TRAILER_COUPLING_FIX",
    "trimLine": "PREMIUM",
    "modelRange": "PDE",
    "firstModelsProductionDate": "201701",
    "batteryCapacity": 999,
    "powerAssistedSteering": true,
    "roofRails": true,
    "skiBag": true,
    "sportPackage": true,
    "sportSeats": true,
    "sunroof": true,
    "tractionControlSystem": true,
    "tv": true,
    "alarmSystem": true,
    "armRest": true,
    "heatedWindshield": true,
    "heatedSteeringWheel": true,
    "hillStartAssist": true,
    "electricTailgate": true,
    "leatherSteeringWheel": true,
    "lumbarSupport": true,
    "massageSeats": true,
    "fatigueWarningSystem": true,
    "nightVisionAssist": true,
    "emergencyCallSystem": true,
    "tirePressureMonitoring": true,
    "paddleShifters": true,
    "electricHeatedRearSeats": true,
    "soundSystem": true,
    "voiceControl": true,
    "touchscreen": true,
    "usb": true,
    "trafficSignRecognition": true,
    "highBeamAssist": true,
    "summerTires": true,
    "winterTires": true,
    "allSeasonTires": true,
    "steelWheels": true,
    "glareFreeHighBeam": true,
    "headlightWasherSystem": true,
    "winterPackage": true,
    "smokersPackage": true,
    "distanceWarningSystem": true,
    "electricBackseatAdjustment": true,
    "ambientLighting": true,
    "wifiHotspot": true,
    "carplay": true,
    "androidAuto": true,
    "digitalCockpit": true
```

--------------------------------

### Retrieve Image Reference

Source: https://services.mobile.de/manual/new-seller-api.html

Example of the JSON structure returned for an image reference URL.

```json
{
    "ref": "https://img.classistatic.de/api/v1/mo-prod/images/46/467621f9-dcca-4c7f-ba2b-5f50942b713b?rule=mo-640.jpg"
}
```

--------------------------------

### Location Header Example

Source: https://services.mobile.de/manual/seller-api-legacy.html

Shows the format of the Location header returned upon successful resource creation.

```text
Location: https://services.mobile.de/seller-api/sellers/123/ads/456
```

--------------------------------

### Retrieve Ad Statistics Request

Source: https://services.mobile.de/manual/new-seller-api.html

Example HTTP GET request to fetch statistics for a specific ad.

```http
GET /seller-api/sellers/12/ads/217221/statistic HTTP/1.1
Host: services.mobile.de
Accept: application/vnd.de.mobile.api+json
```

--------------------------------

### Direct Offer Request and Response

Source: https://services.mobile.de/manual/new-seller-api.html

Example HTTP request and the corresponding JSON response for a direct offer.

```http
GET https://services.mobile.de/seller-api/sellers/11/ads/13318/direct-offer HTTP/1.1
Accept: application/vnd.de.mobile.api+json
```

```http
HTTP/1.1 200 OK
Date: Fri, 17 Jul 2026 12:19:34 GMT
Content-Type: application/vnd.de.mobile.api+json
Content-Length: 139

{
  "offerText": "Here is 15% discount if you reach out in the next 7 days",
  "validUntil": "2023-10-30T12:00:00Z",
  "mobileAdId": 0,
  "blocked": false
}
```

--------------------------------

### Retrieve Seller Feature Settings

Source: https://services.mobile.de/manual/changelog.html

Example response from the feature-settings endpoint showing current booking assistant and cost control configurations.

```json
{
  "bookingAssistant": {
    "topOfPage": {
      "mobileAdIds": [12345, 5324, 54564, 56456546, 45645]
    },
    "eyeCatcher": {
      "mobileAdIds": [4535, 768768, 231342, 45646]
    }
  },
  "costControl": {
    "topOfPage": {}
  }
}
```

--------------------------------

### Consume lead events from the beginning

Source: https://services.mobile.de/manual/lead-api.html

Use a zero cursor to fetch the entire history of lead events.

```http
GET /lead-api/sellers/12/events?cursor=0
Host: services.mobile.de
```

--------------------------------

### Create Direct Offer Success

Source: https://services.mobile.de/manual/new-seller-api.html

Example of a successful PUT request to create a direct offer, including the required headers and JSON payload.

```bash
curl -X PUT 'https://services.mobile.de/seller-api/sellers/11/ads/13318/direct-offer' \
     -H 'Accept: application/vnd.de.mobile.api+json' \
     -H 'Content-Type: application/vnd.de.mobile.api+json; charset=ISO-8859-1' -d '
{
  "offerText": "Here is 15% discount if you reach out in the next 7 days",
  "validForDays": 3
}
'
```

```http
PUT https://services.mobile.de/seller-api/sellers/11/ads/13318/direct-offer HTTP/1.1
Accept: application/vnd.de.mobile.api+json
Content-Type: application/vnd.de.mobile.api+json; charset=ISO-8859-1

{
  "offerText": "Here is 15% discount if you reach out in the next 7 days",
  "validForDays": 3
}
```

```http
HTTP/1.1 201 Created
Date: Fri, 17 Jul 2026 12:19:34 GMT
Content-Type: application/vnd.de.mobile.api+json
Location: http://localhost:42435/sellers/11/ads/13318/direct-offer
Content-Length: 0
```

--------------------------------

### Configure Leasing Rates in Seller-API

Source: https://services.mobile.de/manual/changelog.html

Example structure for including new monthly cost parameters within the rates object.

```json
{
    ...
    rates:[{
        ...
        "maintenanceMonthlyCost": "10.00",
        "wearMonthlyCost": "11.00",
        "maintenanceAndWearCombinedMonthlyCost": "21.00",
        "liabilityInsuranceMonthlyCost": "15.00",
        "liabilityInsuranceDeductible": "200.00",
        "fullyComprehensiveInsuranceMonthlyCost": "25.00",
        "fullyComprehensiveInsuranceDeductible": "300.00",
        "vehicleTaxMonthlyCost": "12.00",
        "summerAndWinterTiresMonthlyCost": "50.00",
        "tuevMonthlyCost": "22.00",
        "returnInsuranceMonthlyCost": "15.00"
    }]
}
```

--------------------------------

### GET /lead-api/sellers/{sellerId}/events

Source: https://services.mobile.de/manual/lead-api.html

Retrieves a list of lead events for a specific seller. Use the cursor parameter to paginate through events, starting from a specific point or from the beginning using '0'.

```APIDOC
## GET /lead-api/sellers/{sellerId}/events

### Description
Retrieves lead events for a given seller. This endpoint supports pagination via a cursor.

### Method
GET

### Endpoint
/lead-api/sellers/{sellerId}/events

### Parameters
#### Path Parameters
- **sellerId** (string) - Required - The unique identifier of the seller.

#### Query Parameters
- **cursor** (string) - Required - The cursor position to start fetching events from. Use '0' to start from the beginning.
```

--------------------------------

### Get all image URLs

Source: https://services.mobile.de/manual/seller-api-legacy.html

Retrieves all image URLs associated with a specific ad using a GET request.

```HTTP
GET /seller-api/sellers/123/ads/456/images HTTP/1.0
Host: services.mobile.de
X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf
Accept: application/vnd.de.mobile.seller-ad-v1.1+xml

```

--------------------------------

### Error Response Examples

Source: https://services.mobile.de/manual/new-seller-api.html

Examples of error responses returned by the API for XML parsing issues and validation failures.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<errorResponse>
  <errors>
    <error>
      <key>xml-parse-error</key>
      <args>
        <arg>
          <key>parser-message</key>
          <value>ParseError at [row,col]:[1,768]
Message: The element type "vehicleClass" must be terminated by the matching end-tag "&lt;/vehicleClass&gt;".</value>
        </arg>
        <arg>
          <key>line</key>
          <value>1</value>
        </arg>
        <arg>
          <key>column</key>
          <value>768</value>
        </arg>
      </args>
    </error>
  </errors>
</errorResponse>
```

```json
{
    "errors": [
        {
            "key": "envkv_energy_efficiency_class_is_empty"
        },
        {
            "key": "delivery-period-xor-delivery-date"
        }
    ]
}
```

--------------------------------

### Manage Ad Feature Bookings

Source: https://services.mobile.de/manual/changelog.html

Examples showing the structure of bookable features, how to request feature changes, and the format for warning responses when bookings are restricted.

```json
"bookableFeatures": {
  "topOfPage": {
    "active": true,
    "blocked": true,
    "reason": "BOOKING_ASSISTANCE"
  },
  "redPencil": {
    "active": true
  },
  "eyeCatcher": {
    "active": false,
    "blocked": true,
    "reason": "COST_CONTROL"
  }
...
...
... # All features incl. Status listed here
}
```

```json
"bookableFeatures": {
  "topOfPage": {
    "active": true
  },
  "eyeCatcher": {
    "active": false
  }
}
```

```json
{
  "warnings": [
    {
      "key": "restricted-feature",
      "args": [
        {
          "key": "reason",
          "value": "BOOKING_ASSISTANCE"
        },
        {
          "key": "feature",
          "value": "topOfPage"
        },
        {
          "key": "active",
          "value": "true"
        }
      ]
    }
  ]
}
```

--------------------------------

### List all sellers response

Source: https://services.mobile.de/manual/new-seller-api.html

Returns a JSON object containing a list of sellers with their respective settings and configuration details.

```json
HTTP/1.1 200 OK
Content-Type: application/vnd.de.mobile.api+json

{
    "sellers": [
        {
            "mobileSellerId": "12",
            "customerNumber": "8",
            "type": "DEALER",
            "siteId": "GERMANY",
            "readonly": false,
            "settings": {
                "maxImages": 30,
                "maxHighlights": 3,
                "usedCarSeals": [
                    "VW",
                    "AUDI"
                ],
                "automatedExports" : [
                    {
                        "eligible" : true,
                        "marketplace" : "ebay-kleinanzeigen.de",
                        "active" : false
                     }
                ],
                "videoUrl" : true,
                "leasing": {
                    "maxPrivateRates": 16,
                    "maxCommercialRates": 16
                }
            },
            "companyName": "Smoke AG"
        },
        {
            "mobileSellerId": "2173",
            "customerNumber": "2186",
            "type": "DEALER",
            "siteId": "GERMANY",
            "readonly": false,
            "settings": {
                "maxImages": 15,
                "maxHighlights": 0,
                "usedCarSeals": [
                    "VW"
                ],
                "automatedExports" : [
                    {
                        "eligible" : true,
                        "marketplace" : "ebay-kleinanzeigen.de",
                        "active" : false
                     }
                ],
                "videoUrl" : true,
                "leasing": {
                    "maxPrivateRates": 16,
                    "maxCommercialRates": 16
                }
            },
            "companyName": "Weatherill's"
        }
    ]
}
```

--------------------------------

### Get Interior Auto Panorama

Source: https://services.mobile.de/manual/new-seller-api.html

Use the GET method to retrieve the current interior Auto Panorama configuration for an ad.

```bash
curl -X GET 'https://services.mobile.de/seller-api/sellers/28481/ads/34561/auto-panorama/interior' \
     -H 'Accept: application/vnd.de.mobile.api+json'
```

```http
GET https://services.mobile.de/seller-api/sellers/28481/ads/34561/auto-panorama/interior HTTP/1.1
Accept: application/vnd.de.mobile.api+json
```

```http
HTTP/1.1 200 OK
Date: Fri, 17 Jul 2026 12:19:18 GMT
Content-Type: application/vnd.de.mobile.api+json
Content-Length: 36

{
  "image": {
    "ref": "/api/media/14796"
  }
}
```

--------------------------------

### GET /refdata/classes

Source: https://services.mobile.de/manual/reference-data.html

Retrieves vehicle classes.

```APIDOC
## GET /refdata/classes

### Description
Retrieves a list of vehicle classes.

### Method
GET

### Endpoint
https://services.mobile.de/refdata/classes

### Parameters
#### Header Parameters
- **Accept** (string) - Required - Must be 'application/xml'.
```

--------------------------------

### GET /refdata/colors

Source: https://services.mobile.de/manual/ad-stream.html

Retrieves the list of available colors.

```APIDOC
## GET /refdata/colors

### Description
Returns the list of valid color values.

### Method
GET

### Endpoint
/refdata/colors
```

--------------------------------

### Leasing Budget Control API Argument

Source: https://services.mobile.de/manual/changelog.html

Example of the JSON structure used for leasing budget warnings.

```json
                  "args": [
                    {
                      "key": "reason",
                      "value": "Monthly budget limit has been reached,
                       newly added rates or actions are processed but the leasing offer
                       will be paused automatically until budget is increased."
                    }
                  ]
                }
              ]
            }
```

--------------------------------

### POST /lead-api/sellers/{mobileSellerId}/sandbox/initial-submission

Source: https://services.mobile.de/manual/lead-api.html

Generates a new lead for a specific dealer with an initial message.

```APIDOC
## POST /lead-api/sellers/{mobileSellerId}/sandbox/initial-submission

### Description
This endpoint generates a new lead for a specific dealer with an initial message.

### Method
POST

### Endpoint
/lead-api/sellers/{mobileSellerId}/sandbox/initial-submission

### Parameters
#### Path Parameters
- **mobileSellerId** (string) - Required - ID of the dealer account under management

### Response
#### Success Response (201)
- **eventId** (string) - ID of the generated event
- **leadId** (string) - ID of the lead
```

--------------------------------

### MessagingLeadResubmitted cURL Request

Source: https://services.mobile.de/manual/lead-api.html

Example request for triggering a resubmission event.

```bash
curl -X POST "https://services.sandbox.mobile.de/lead-api/sellers/123456/sandbox/buyer-search-behaviour?leadId=LEAD123" \
     -H 'Authorization: Basic dGVzdC1stttWWW123==' # Base64 encoded string
```

--------------------------------

### Retrieve Seller Trial Period Information

Source: https://services.mobile.de/manual/changelog.html

Example of the JSON response structure for seller trial periods in the Seller-API.

```http
GET https://services.mobile.de/seller-api/sellers/12

{
  "mobileSellerId": "12",
  "customerNumber": "8",

  ...

  "trialPeriods": [
    {
        "bookableFeature": "adTurbo",
        "freeTries": "10",
        "trialPeriodStart": "2018-04-01T10:00:00Z"
        "trialPeriodEnd": "2018-04-30T10:00:00Z"

    }
  ]
}
```

--------------------------------

### GET /refdata/airbags

Source: https://services.mobile.de/manual/search-api.html

Retrieves a list of site-independent reference data for airbags.

```APIDOC
## GET /refdata/airbags

### Description
Returns a list of available airbag types.

### Method
GET

### Endpoint
/refdata/airbags
```

--------------------------------

### GET /search-api/ad/{ad-key}

Source: https://services.mobile.de/manual/search-api.html

Fetches a single advertisement by its unique ad-key.

```APIDOC
## GET /search-api/ad/{ad-key}

### Description
Retrieves the details of a single advertisement using its unique identifier.

### Method
GET

### Endpoint
/search-api/ad/{ad-key}

### Parameters
#### Path Parameters
- **ad-key** (String) - Required - The unique identifier for the advertisement.
```

--------------------------------

### Compare HTML Compaction in Lead Emails

Source: https://services.mobile.de/manual/changelog.html

Demonstrates the change from compacted HTML to formatted, readable HTML structure.

```html
<body><table><tr><td><strong>Enquiry about your vehicle</strong></td></tr></table>/body>
```

```html
<body>
    <table>
        <tr>
            <td><strong>Enquiry about your vehicle</strong></td>
        </tr>
    </table>
</body>
```

--------------------------------

### GET /search-api/ad/{id}

Source: https://services.mobile.de/manual/search-api-2024-attributes-examples.html

Retrieves the details of a specific advertisement by its ID.

```APIDOC
## GET /search-api/ad/{id}

### Description
Retrieves the detailed information for a specific advertisement.

### Method
GET

### Endpoint
/search-api/ad/{id}

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the advertisement.

### Response
#### Success Response (200)
- **ad** (object) - The advertisement details including extended attributes like suspendedFrontAxle, heatPump, and various bed types.
```

--------------------------------

### Retrieve Sellers Response Headers

Source: https://services.mobile.de/manual/seller-api-legacy.html

Example of the HTTP status-line and headers returned upon a successful request.

```http
HTTP/1.1 200 OK
Content-Type: application/vnd.de.mobile.seller-v2.0+xml

```

--------------------------------

### Seller API Response Example

Source: https://services.mobile.de/manual/new-seller-api.html

Sample JSON response structure returned when querying the sellers endpoint.

```json
"sellers": [
    {
      "mobileSellerId": "884",
      "customerNumber": "873",
      "type": "DEALER",
      "siteId": "GERMANY",
      "readonly": false,
      "settings": {
        "maxImages": 15,
        "maxHighlights": 1,
        "automatedExports": [
          {
            "marketplace": "ebay-kleinanzeigen.de",
            "eligible": true,
            "active": false
          }
        ],
        "videoUrl": false
      },
      "companyName": "The Wall"
    }
  ]
}
```

--------------------------------

### GET /search-api/search

Source: https://services.mobile.de/manual/search-api-2024-attributes-examples.html

Search for vehicles using various attributes and filters.

```APIDOC
## GET /search-api/search

### Description
Perform a search for vehicles using specific attributes and range filters.

### Method
GET

### Endpoint
/search-api/search

### Parameters
#### Query Parameters
- **trailerLoadBraked.min** (Int) - Optional - Minimum braked trailer load
- **trailerLoadBraked.max** (Int) - Optional - Maximum braked trailer load
- **trailerLoadUnbraked.min** (Int) - Optional - Minimum unbraked trailer load
- **trailerLoadUnbraked.max** (Int) - Optional - Maximum unbraked trailer load
- **maxNoseWeight.min** (Int) - Optional - Minimum nose weight
- **maxNoseWeight.max** (Int) - Optional - Maximum nose weight
- **operatingWeight.min** (Int) - Optional - Minimum operating weight
- **operatingWeight.max** (Int) - Optional - Maximum operating weight
- **seatHeight.min** (Int) - Optional - Minimum seat height
- **seatHeight.max** (Int) - Optional - Maximum seat height
- **cylinder.min** (Int) - Optional - Minimum number of cylinders
- **cylinder.max** (Int) - Optional - Maximum number of cylinders
- **fuelTankVolume.min** (Int) - Optional - Minimum fuel tank volume
- **fuelTankVolume.max** (Int) - Optional - Maximum fuel tank volume
- **standingHeight.min** (Int) - Optional - Minimum standing height
- **standingHeight.max** (Int) - Optional - Maximum standing height
- **payload.min** (Int) - Optional - Minimum payload
- **payload.max** (Int) - Optional - Maximum payload
- **seatbeltSeats.min** (Int) - Optional - Minimum number of seatbelt seats
- **seatbeltSeats.max** (Int) - Optional - Maximum number of seatbelt seats
- **heating** (Set of String) - Optional - Heating type (GAS, DIESEL, PETROL, ELECTRICITY, WOOD)
- **heightType** (Set of String) - Optional - Height type (H1, H2, H3)
- **lengthType** (Set of String) - Optional - Length type (L1, L2, L3, L4, L5)
- **driveType** (Set of String) - Optional - Drive type (FRONT, REAR, ALL_WHEEL)
- **wheelBase** (Set of String) - Optional - Wheel base (SHORT, MIDDLE, LONG, EXTRA_LONG)
```

--------------------------------

### GET /refdata/sites/{site-key}/classes

Source: https://services.mobile.de/manual/reference-data.html

Retrieves site-specific vehicle classes.

```APIDOC
## GET /refdata/sites/{site-key}/classes

### Description
Retrieves vehicle classes specific to a given site.

### Method
GET

### Endpoint
https://services.mobile.de/refdata/sites/{site-key}/classes

### Parameters
#### Path Parameters
- **site-key** (string) - Required - The identifier for the site.
```

--------------------------------

### POST /lead-api/sellers/{mobileSellerId}/sandbox/initial-submission-leasing

Source: https://services.mobile.de/manual/lead-api.html

Generates a new leasing lead for a specific dealer.

```APIDOC
## POST /lead-api/sellers/{mobileSellerId}/sandbox/initial-submission-leasing

### Description
This endpoint generates a new leasing lead for a specific dealer, including leasing-specific conditions.

### Method
POST

### Endpoint
/lead-api/sellers/{mobileSellerId}/sandbox/initial-submission-leasing

### Parameters
#### Path Parameters
- **mobileSellerId** (string) - Required - ID of the dealer account under management

### Response
#### Success Response (201)
- **eventId** (string) - ID of the generated event
- **leadId** (string) - ID of the lead
```

--------------------------------

### Conflicting Field Warning

Source: https://services.mobile.de/manual/changelog.html

Example response when both individualContactId and useDefaultContact are provided in a request.

```json
{
  "warnings": [
    {
      "key": "conflicting-field",
      "args": [
        {
          "key": "path",
          "value": "individualContactId"
        },
        {
          "key": "cause",
          "value": "IndividualContactId is ignored when useDefaultContact is present."
        }
      ]
    }
  ]
}
```

--------------------------------

### Username and Password Token Header

Source: https://services.mobile.de/manual/seller-api-legacy.html

Example of the temporary authentication header format using username and password.

```http
X-MOBILE-SELLER-TOKEN: myuser:mypassword
```

--------------------------------

### List Sellers via cURL

Source: https://services.mobile.de/manual/new-seller-api.html

Perform a GET request to retrieve all sellers associated with the test account using HTTP basic authentication.

```bash
curl -vs -u username:password \
     -H "Accept: application/vnd.de.mobile.api+json" \
     https://sandbox.services.mobile.de/seller-api/sellers
```

--------------------------------

### Seller API Token Header

Source: https://services.mobile.de/manual/seller-api-legacy.html

Example of the deprecated X-MOBILE-SELLER-TOKEN header format.

```http
X-MOBILE-SELLER-TOKEN: hf76g364gf6gjdsgfhsdgfzf
```
Tokens:
Raw