GET: Aggregate Offers Native

Endpoint Overview

Title: Aggregative Offers Native

Description: This endpoint returns min prices and offer count for specific make_id or series_id of the AMS Database and generates a list of minimum prices for different financing options like „Leasing, Auto-Abo, Neuwagenkauf, Gebrauchtwagenkauf“.

We also return pre configured filter strings to add them to the search page url as get parameters so you can link to search widget.

HTTP Method

Method: GET

URL Path

ams/aggregate-offers-native

Final URL: https://api.mivodo.com/ams/aggregate-offers-native

Query Parameters

Parameter	Type	Required	Description	Default
series_id	integer	Yes*	SeriesId of AMS	–
make_id	integer	Yes*	MakeId of AMS
vehicle_type_slug	string	No	AMS Vehicle Types	–
fuel_type_slug	string	No	AMS Fuel Type Slugs	–

Headers

Header	Description
Content-Type	application/json

Example Request

GET /ams/aggregate-offers-native?series_id=461&make_id=37&vehicle_type_slug=Limousine&customer_groups=gewerbe

Example Response

{
    "message": "OK",
    "data": {
        "result": {
            "label": "Mercedes-Benz S-Klasse",
            "filter_string": "mvd_makes_models=mercedes-benz-s-klasse&mvd_subpartner_id=5&mvd_sort=price_asc",
            "offer_data": {
                "vehicle_leasing_offers": {
                    "label": "Leasing",
                    "filter_string": "mvd_type=vehicle-leasing-offers&mvd_customer_groups=privat&mvd_subpartner_id=5&mvd_sort=price_asc",
                    "count": "13 Angebote",
                    "min_gross_price": "1.001,00 € / Monat",
                    "max_gross_price": "3.831,85 € / Monat"
                },
                "vehicle_subscription_offers": {
                    "label": "Auto Abo",
                    "filter_string": "mvd_type=vehicle-subscription-offers&mvd_customer_groups=privat&mvd_subpartner_id=5&mvd_sort=price_asc",
                    "count": "1 Angebot",
                    "min_gross_price": "2.709,00 € / Monat",
                    "max_gross_price": "2.709,00 € / Monat"
                },
                "vehicle_buy_new_offers": {
                    "label": "Neuwagen",
                    "filter_string": "mvd_type=vehicle-buy-offers&mvd_vehicle_conditions=new&mvd_customer_groups=privat&mvd_subpartner_id=5&mvd_sort=price_asc",
                    "count": "19 Angebote",
                    "min_gross_price": "112.086,00 €",
                    "max_gross_price": "237.208,00 €"
                },
                "vehicle_buy_used_offers": {
                    "label": "Gebrauchtwagen",
                    "filter_string": "mvd_type=vehicle-buy-offers&mvd_vehicle_conditions=used&mvd_customer_groups=privat&mvd_subpartner_id=5&mvd_sort=price_asc",
                    "count": "47 Angebote",
                    "min_gross_price": "40.888,00 €",
                    "max_gross_price": "197.580,00 €"
                }
            }
        }
    }
}

Status Codes

Status Code	Meaning
200	Success, data returned.
400	Invalid request parameters.
500	Internal server error.

Error Response Example

Example of a 404 error response:

{
    "status_code": 400,
    "timestamp": "2024-09-12T09:29:39.749Z",
    "path": "/ams/aggregate-offers-native",
    "message": [
        "issue 1",
        "issue 2"
    ]
}