CARFAX Value Estimate (by VIN)

{
  "type": "object",
  "required": [
    "vin"
  ],
  "properties": {
    "vin": {
      "type": "string",
      "description": "Vehicle Identification Number (VIN) of an active CARFAX listing. Obtain from search_used_car_listings results."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "badge": {
          "type": [
            "string",
            "null"
          ],
          "description": "CARFAX's plain-language value rating for the listing (observed: 'GREAT'). The vendor's docs describe GOOD, FAIR, and HIGH as other possible values, and null when CARFAX has not assigned a badge; no fixture observed a value other than 'GREAT'."
        },
        "onePrice": {
          "type": "number",
          "description": "CARFAX's own estimated fair price for the listing, in USD."
        },
        "listPrice": {
          "type": "number",
          "description": "The dealer's list price for the listing, in USD."
        },
        "onePriceArrows": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "icon": {
                "type": "string",
                "description": "A short internal name for this factor's icon."
              },
              "text": {
                "type": "string",
                "description": "Plain-language label for this factor (observed: 'Service History', 'Personal Vehicle', 'Multiple Owners', 'Minor Damage', 'No Accidents Reported', '1-Owner Vehicle')."
              },
              "arrow": {
                "type": "string",
                "description": "Direction of this factor's effect on price (observed: 'UP', 'DOWN')."
              },
              "order": {
                "type": "number",
                "description": "Display order, starting at 1."
              },
              "iconName": {
                "type": "string",
                "description": "A second, differently-formatted icon identifier for this factor."
              }
            },
            "additionalProperties": true
          },
          "description": "The factors behind the valuation, each pointing the price up or down. Both fixtures observed 4 entries; the count varies with the listing's history."
        },
        "monthlyPaymentEstimate": {
          "type": "object",
          "properties": {
            "price": {
              "type": "number",
              "description": "The vehicle's price in USD, used as the loan basis."
            },
            "loanAmount": {
              "type": "number",
              "description": "Price minus down payment, in USD."
            },
            "interestRate": {
              "type": "number",
              "description": "Assumed annual interest rate, as a percent."
            },
            "termInMonths": {
              "type": "number",
              "description": "Assumed loan term in months."
            },
            "monthlyPayment": {
              "type": "number",
              "description": "The estimated monthly payment, in USD."
            },
            "downPaymentAmount": {
              "type": "number",
              "description": "Assumed down payment, in USD."
            },
            "downPaymentPercent": {
              "type": "number",
              "description": "Assumed down payment, as a percent."
            }
          },
          "description": "A standard-assumptions monthly payment estimate for the listing.",
          "additionalProperties": true
        }
      },
      "description": "The valuation payload for the listing.",
      "additionalProperties": true
    },
    "status": {
      "type": "string",
      "description": "'success' on both real active-listing calls observed."
    }
  },
  "description": "The CARFAX Value result for an active listing, as returned at routing.responseResultPath ($.output). Both fixtures behind this schema are active-listing results; the vendor's own docs describe a badge of null when CARFAX has not rated a listing, which no fixture observed, so `badge` is typed to allow null on that basis alone.",
  "additionalProperties": true
}