AramisAuto · Schema

Aramisauto Catalog Search Request.Schema

CompanyConsumerAutomotiveE-CommerceUsed CarsVehicle DataMarketplaceRetailAuto FinanceFranceJSON-Schema

Properties

Name Type Description
$schema string
criteria object
facets array
order array
limit integer
offset integer
fields array
View JSON Schema on GitHub

JSON Schema

aramisauto-catalog-search-request.schema.json Raw ↑
{
  "$id": "https://schemas.aramis.group/catalog/search-request.schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "$schema": { "type": "string", "pattern": "\/catalog\/search-request\\.schema\\.json$" },

    "criteria": { "type": "object", "additionalProperties": false, "properties": {
      "text": { "type": "string" },
      "offerId": { "type": "object", "additionalProperties": false, "required": ["in"], "properties": {
        "in": { "type": "array", "items": { "type": "string", "minLength": 1 }}
      }},
      "vehicleId": { "type": "object", "additionalProperties": false, "required": ["in"], "properties": {
        "in": { "type": "array", "items": { "type": "string", "minLength": 1 }}
      }},
      "offerType.id": { "type": "object", "additionalProperties": false, "required": ["in"], "properties": {
        "in": { "type": "array", "items": { "$ref": "base.schema.json#/$defs/offer-type-id"}}
      }},
      "firstCirculationDate": { "type": "object", "additionalProperties": false, "required": ["min", "max"], "properties": {
        "min": { "type": ["null", "string"], "format": "date", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" },
        "max": { "type": ["null", "string"], "format": "date", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$" }
      }},
      "milage.km": { "type": "object", "additionalProperties": false, "required": ["min", "max"], "properties": {
        "min": { "type": ["null", "integer"] },
        "max": { "type": ["null", "integer"] }
      }},
      "euronorm": { "type": "object", "additionalProperties": false,"required": ["in"], "properties": {
        "in": { "type": "array", "items": { "$ref": "base.schema.json#/$defs/euronorm-string"} }
      }},
      "critair": { "type": "object", "additionalProperties": false,"required": ["in"], "properties": {
        "in": { "type": "array", "items": { "$ref": "base.schema.json#/$defs/critair-string"} }
      }},

      "sellingPriceWithTaxes": { "type": "object", "additionalProperties": false, "required": ["min", "max"], "properties": {
        "min": { "type": ["null", "number"] },
        "max": { "type": ["null", "number"] }
      }},
      "sellingPriceWithTakeOverWithTaxes": { "type": "object", "additionalProperties": false, "required": ["min", "max"], "properties": {
        "min": { "type": ["null", "number"] },
        "max": { "type": ["null", "number"] }
      }},
      "indicativeMinimumMonthlyInstallment": { "type": "object", "additionalProperties": false, "required": ["min", "max"], "properties": {
        "min": { "type": ["null", "number"] },
        "max": { "type": ["null", "number"] }
      }},
      "indicativeMinimumMonthlyInstallmentWithTakeover": { "type": "object", "additionalProperties": false, "required": ["min", "max"], "properties": {
        "min": { "type": ["null", "number"] },
        "max": { "type": ["null", "number"] }
      }},
      "maker": { "type": "object", "additionalProperties": false, "required": ["in"], "properties": {
        "in": { "type": "array", "items": { "type": "string", "minLength": 1 }}
      }},
      "model": { "type": "object", "additionalProperties": false, "required": ["in"], "properties": {
        "in": { "type": "array", "items": { "type": "string", "minLength": 1 }}
      }},
      "simpleColor.id": { "type": "object", "additionalProperties": false, "required": ["in"], "properties": {
        "in": { "type": "array", "items": { "$ref": "base.schema.json#/$defs/simple-color-id"}}
      }},
      "simpleEquipment.id": { "type": "object", "additionalProperties": false, "required": ["in"], "properties": {
        "in": { "type": "array", "items": { "$ref": "base.schema.json#/$defs/simple-equipment-id"}}
      }},
      "category.id": { "type": "object", "additionalProperties": false, "required": ["in"], "properties": {
        "in": { "type": "array", "items": { "$ref": "base.schema.json#/$defs/category-id"}}
      }},
      "energyType.id": { "type": "object", "additionalProperties": false, "required": ["in"], "properties": {
        "in": { "type": "array", "items": { "$ref": "base.schema.json#/$defs/energy-type-id"}}
      }},
      "transmission.id": { "type": "object", "additionalProperties": false, "required": ["in"], "properties": {
        "in": { "type": "array", "items": { "$ref": "base.schema.json#/$defs/transmission-id"}}
      }},
      "drive.id": { "type": "object", "additionalProperties": false, "required": ["in"], "properties": {
        "in": { "type": "array", "items": { "$ref": "base.schema.json#/$defs/drive-id"}}
      }},
      "promotion.id": { "type": "object", "additionalProperties": false, "required": ["in"], "properties": {
        "in": { "type": "array", "items": { "type": "string", "minLength": 1 }}
      }},
      "doors": { "type": "object", "additionalProperties": false, "required": ["min", "max"], "properties": {
        "min": { "type": ["null", "integer"] },
        "max": { "type": ["null", "integer"] }
      }},
      "seats": { "type": "object", "additionalProperties": false, "required": ["min", "max"], "properties": {
        "min": { "type": ["null", "integer"] },
        "max": { "type": ["null", "integer"] }
      }}
    }},
    "facets": { "type": "array", "uniqueItems": true, "items": { "enum": [
      "offerType",
      "firstCirculationYear",
      "mileage.km.slice",
      "euronorm",
      "critair",
      "sellingPriceWithTaxes.slice",
      "sellingPriceWithTakeOverWithTaxes.slice",
      "indicativeLoadInstallment.slice",
      "maker",
      "model",
      "simpleColor",
      "simpleEquipment",
      "category",
      "segment",
      "energyType",
      "transmission",
      "drive",
      "promotion",
      "doors",
      "seats"
    ]}},
    "order": { "type": "array", "uniqueItems": true, "items": {"type": "object", "additionalProperties": false, "minProperties":1, "maxProperties": 1, "properties": {
      "publicationDate": { "enum": ["asc", "desc"] },
      "mileage.km": { "enum": ["asc", "desc"] },
      "sellingPriceWithTaxes": { "enum": ["asc", "desc"] },
      "sellingPriceWithTakeOverWithTaxes": { "enum": ["asc", "desc"] },
      "indicativeMinimumMonthlyInstallment": { "enum": ["asc", "desc"] },
      "indicativeMinimumMonthlyInstallmentWithTakeover": { "enum": ["asc", "desc"] },
      "maker": { "enum": ["asc", "desc"] },
      "model": { "enum": ["asc", "desc"] },
      "power.ch": { "enum": ["asc", "desc"] },
      "combinedCycleConsumption.ltPer100Km": { "enum": ["asc", "desc"] },
      "combinedCycleConsumption.kwhPer100Km": { "enum": ["asc", "desc"] }
    }}},
    "limit": { "type": "integer", "minimum": 0, "default": 100 },
    "offset": { "type": "integer", "minimum": 0, "default": 0 },
    "fields": { "type": "array", "uniqueItems": true, "items": { "enum": [
      "vin",
      "offerId",
      "vehicleId",
      "offerType.id",
      "offerType.label",
      "status.id",
      "status.label",
      "originCountry.id",
      "originCountry.label",
      "isMarketplace",
      "firstCirculationDate",
      "warrantyExpirationDate",
      "mileage.km",
      "euronorm",
      "critair",
      "frenchFiscalPower",
      "frenchGenre",
      "belgianFiscalPower",
      "belgianOtoto.url",
      "belgianCarpass.url",
      "catalogPriceWithOptionsWithTaxes",
      "takeoverPremium",
      "sellingPriceWithTaxes",
      "discount.percent",
      "sellingPriceWithTakeoverWithTaxes",
      "discountWithTakeover.percent",
      "indicativeLoan.monthlyInstallment",
      "indicativeLoan.months",
      "variants.vehicleId",
      "variants.status.id",
      "variants.status.label",
      "variants.manufacturerColor",
      "variants.simpleColor.id",
      "variants.simpleColor.label",
      "variants.simpleColor2.id",
      "variants.simpleColor2.label",
      "variants.photo.url",
      "media.type",
      "media.url",
      "media.orientation",
      "photo.url",
      "maker",
      "model",
      "engine",
      "finish",
      "version",
      "interior",
      "manufacturerColor",
      "expertComments",
      "category.id",
      "category.label",
      "segment.id",
      "segment.label",
      "energyType.id",
      "energyType.label",
      "simpleColor.id",
      "simpleColor.label",
      "interiorSimpleColor.id",
      "interiorSimpleColor.label",
      "transmission.id",
      "transmission.label",
      "drive.id",
      "drive.label",
      "equipments.label",
      "equipments.category.id",
      "equipments.category.label",
      "simpleEquipments.id",
      "simpleEquipments.label",
      "options.label",
      "options.priceWithTaxes",
      "promotions.id",
      "promotions.label",
      "promotions.color",
      "doors",
      "gears",
      "seats",
      "cylinders",
      "power.ch",
      "power.kw",
      "engineCapacity.cc",
      "urbanCycleConsumption.ltPer100Km",
      "urbanCycleConsumption.kwhPer100Km",
      "extraUrbanCycleConsumption.ltPer100Km",
      "extraUrbanCycleConsumption.kwhPer100Km",
      "combinedCycleConsumption.ltPer100Km",
      "combinedCycleConsumption.kwhPer100Km",
      "co2EmissionsNedc.gramsPerKm",
      "co2EmissionsWltp.gramsPerKm",
      "height.meters",
      "width.meters",
      "length.meters",
      "wheelbase.meters",
      "unloadedWeight.kg",
      "totalAuthorizedWeight.kg",
      "minBootSpaceBackCapacity.lt",
      "maxBootSpaceBackCapacity.lt",
      "bootSpaceFrontCapacity.lt",
      "maxSpeed.kmPerHour",
      "electricRangeNedc.km",
      "electricRangeWltp.km",
      "electricBatteryWarrantyPeriod.km",
      "electricBatteryWarrantyPeriod.years",
      "electricBatteryStateOfHealth.percent",
      "electricBatteryCapacity.kwh",
      "electricBatteryType",
      "electricBatterySlowChargePower.kw",
      "electricBatterySlowChargeTime.minutes",
      "electricBatteryMediumChargePower.kw",
      "electricBatteryMediumChargeTime.minutes",
      "electricBatteryQuickChargePower.kw",
      "electricBatteryQuickChargeTime.minutes",
      "electricBatteryCost",
      "electricMaximumPowerCarElectricalOutlet.kw",
      "electricMaximumPowerCarDirectCurrent.amperes"
    ]}}
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/aramisauto-catalog-search-request.schema"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.