Contract
input_schema.json
{
"type": "object",
"required": [
"vin"
],
"properties": {
"vin": {
"type": "string",
"description": "Vehicle Identification Number (VIN) of an active CARFAX listing. Obtain from search_used_car_listings or search_new_car_listings results."
},
"zip": {
"type": "string",
"description": "5-digit US ZIP code for location-specific data such as distance to dealer."
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The listing's own composite record id."
},
"vin": {
"type": "string"
},
"fees": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fee": {
"type": "number"
},
"feeType": {
"type": "string"
}
},
"additionalProperties": true
}
},
"fuel": {
"type": "string"
},
"make": {
"type": "string"
},
"trim": {
"type": "string"
},
"year": {
"type": "number"
},
"badge": {
"type": "string",
"description": "CARFAX's own deal-quality label for this listing, e.g. 'GREAT'."
},
"model": {
"type": "string"
},
"dealer": {
"type": "object",
"properties": {
"zip": {
"type": "string"
},
"city": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"type": "string"
},
"state": {
"type": "string"
},
"address": {
"type": "string"
},
"feeBadge": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"isValid": {
"type": "boolean"
}
},
"additionalProperties": true
},
"latitude": {
"type": "string"
},
"groupName": {
"type": "string"
},
"longitude": {
"type": "string"
},
"badgeDetails": {
"type": "object",
"properties": {
"badgeUrls": {
"type": "object",
"properties": {
"small": {
"type": "null",
"description": "Always null: stripped badge-image URL."
}
},
"additionalProperties": true
},
"badgeAltText": {
"type": "object",
"properties": {
"en": {
"type": "string"
}
},
"additionalProperties": true
},
"topRatedYear": {
"type": "string"
},
"eligibleBadges": {
"type": "array",
"items": {
"type": "string"
}
},
"badgeExperience": {
"type": "string"
}
},
"additionalProperties": true
},
"additionalFee": {
"type": "number"
},
"businessHours": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {
"type": "object",
"properties": {
"open": {
"type": [
"string",
"null"
]
},
"close": {
"type": [
"string",
"null"
]
},
"byAppointment": {
"type": "boolean"
}
},
"additionalProperties": true
}
},
"description": "One entry per day of the week, each keyed by the day name. `close`/`open` are null on a day the dealer is closed (observed on a real Sunday entry)."
},
"dealerReviewDate": {
"type": "string"
},
"showPriceHistory": {
"type": "boolean"
},
"dealerReviewCount": {
"type": "number"
},
"sellMyCarEligible": {
"type": "boolean"
},
"dealerReviewRating": {
"type": "number"
},
"dealerAverageRating": {
"type": "number"
},
"dealerReviewComments": {
"type": "string"
},
"dealerReviewReviewer": {
"type": "string",
"description": "A generic descriptor, e.g. '2023 NISSAN SENTRA SV Owner', not a name."
},
"franchisePartnerships": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"certify": {
"type": "boolean"
}
},
"additionalProperties": true
}
}
},
"description": "The selling dealership's own public business listing -- not a private individual.",
"additionalProperties": true
},
"engine": {
"type": "string"
},
"images": {
"type": "object",
"properties": {
"large": {
"type": "array",
"items": {
"type": "null"
}
},
"small": {
"type": "array",
"items": {
"type": "null"
}
},
"medium": {
"type": "array",
"items": {
"type": "null"
}
},
"baseUrl": {
"type": "null"
},
"firstPhoto": {
"type": "object",
"properties": {
"large": {
"type": "null"
},
"small": {
"type": "null"
},
"medium": {
"type": "null"
}
},
"additionalProperties": true
}
},
"description": "Photo-URL fields exist here but are never populated: the underlying values are stripped before this response is shaped, so every field below is always null.",
"additionalProperties": true
},
"cabType": {
"type": "string",
"description": "'Unspecified' on non-truck listings."
},
"mileage": {
"type": "number"
},
"mpgCity": {
"type": "number"
},
"subTrim": {
"type": "string"
},
"bodytype": {
"type": "string"
},
"onePrice": {
"type": "number",
"description": "The CARFAX Value-adjusted price estimate for this vehicle."
},
"snapshot": {
"type": "array",
"items": {
"type": "object",
"properties": {
"row": {
"type": "number"
},
"icon": {
"type": "string"
},
"text": {
"type": "string",
"description": "May contain HTML markup, e.g. '<strong>'."
},
"iconUrl": {
"type": "null",
"description": "Always null: stripped icon-image URL."
},
"iconName": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "A short ordered list of headline facts about the listing."
},
"advantage": {
"type": "boolean"
},
"bedLength": {
"type": "string",
"description": "'Unspecified' on non-truck listings."
},
"drivetype": {
"type": "string",
"description": "e.g. 'FWD'."
},
"firstSeen": {
"type": "string",
"description": "Date this listing first appeared, YYYY-MM-DD."
},
"listPrice": {
"type": "number"
},
"allInPrice": {
"type": "boolean",
"description": "Whether listPrice already includes fees."
},
"dealerType": {
"type": "string",
"description": "e.g. 'NEW' (a franchise/new-car dealer)."
},
"imageCount": {
"type": "number"
},
"mpgHighway": {
"type": "number"
},
"recordType": {
"type": "string",
"description": "e.g. 'ENHANCED'."
},
"topOptions": {
"type": "array",
"items": {
"type": "string"
}
},
"disclaimers": {
"type": "object",
"properties": {
"srp": {
"type": "object",
"additionalProperties": true
},
"vdp": {
"type": "object",
"additionalProperties": true
},
"lead": {
"type": "object",
"additionalProperties": true
},
"footer": {
"type": "object",
"additionalProperties": true
},
"monthlyPayment": {
"type": "object",
"additionalProperties": true
}
},
"description": "Legal disclaimer text CARFAX requires alongside the listing.",
"additionalProperties": true
},
"followCount": {
"type": "number"
},
"mpgCombined": {
"type": "number"
},
"personalUse": {
"type": "boolean"
},
"reliability": {
"type": "object",
"properties": {
"costBadge": {
"type": "string",
"description": "e.g. 'AVERAGE'."
},
"riskBadge": {
"type": "string",
"description": "e.g. 'AVERAGE'."
},
"averageCost": {
"type": "number",
"description": "Average annual repair cost in USD."
},
"reliabilityPlacement": {
"type": "number",
"description": "Percentile, 0-100."
},
"overallReliabilityBadge": {
"type": "string",
"description": "e.g. 'GOOD'."
},
"reliabilityImpactFactors": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": true
},
"stockNumber": {
"type": "string",
"description": "The selling dealer's internal stock number."
},
"currentPrice": {
"type": "number"
},
"displacement": {
"type": "string"
},
"otherOptions": {
"type": "array",
"items": {
"type": "string"
}
},
"ownerHistory": {
"type": "object",
"properties": {
"icon": {
"type": "string"
},
"text": {
"type": "string"
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"ownerNumber": {
"type": "number"
},
"purchaseDate": {
"type": "string"
},
"endOwnershipDate": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "One entry per prior owner -- city/state only, no owner names."
},
"iconUrl": {
"type": "null",
"description": "Always null: stripped icon-image URL."
},
"iconName": {
"type": "string"
}
},
"additionalProperties": true
},
"transmission": {
"type": "string"
},
"vehiclePrice": {
"type": "number",
"description": "Base vehicle price before fees."
},
"exteriorColor": {
"type": "string"
},
"interiorColor": {
"type": "string"
},
"reliabilityV2": {
"type": "object",
"properties": {
"overallReliabilityBadge": {
"type": "string"
},
"reliabilityImpactFactors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
},
"subText": {
"type": "string",
"description": "Not present on every impact-factor entry observed."
},
"descriptiveText": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"onePriceArrows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"icon": {
"type": "string"
},
"text": {
"type": "string",
"description": "e.g. 'Service History', 'Multiple Owners'."
},
"arrow": {
"type": "string",
"description": "'UP' or 'DOWN'."
},
"order": {
"type": "number"
},
"iconUrl": {
"type": "null",
"description": "Always null: stripped icon-image URL."
},
"arrowUrl": {
"type": "null",
"description": "Always null: stripped icon-image URL."
},
"iconName": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "The factors driving the CARFAX Value price up or down for this vehicle."
},
"sellerComments": {
"type": "string",
"description": "The dealer's free-text listing copy."
},
"serviceHistory": {
"type": "object",
"properties": {
"icon": {
"type": "string"
},
"text": {
"type": "string"
},
"number": {
"type": "number",
"description": "Total count of service records."
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"date": {
"type": "string"
},
"state": {
"type": "string"
},
"source": {
"type": "string",
"description": "The servicing shop's business name/location."
},
"description": {
"type": "string",
"description": "May contain HTML markup."
},
"odometerReading": {
"type": "number"
}
},
"additionalProperties": true
}
},
"iconUrl": {
"type": "null",
"description": "Always null: stripped icon-image URL."
},
"iconName": {
"type": "string"
}
},
"additionalProperties": true
},
"serviceRecords": {
"type": "boolean"
},
"accidentHistory": {
"type": "object",
"properties": {
"icon": {
"type": "string"
},
"text": {
"type": "string"
},
"iconUrl": {
"type": "null",
"description": "Always null: the raw icon-image URL is stripped before it reaches you."
},
"iconName": {
"type": "string"
},
"accidentSummary": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": true
},
"vehicleCondition": {
"type": "string",
"description": "e.g. 'Used'."
},
"vehicleUseHistory": {
"type": "object",
"properties": {
"icon": {
"type": "string"
},
"text": {
"type": "string"
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"useType": {
"type": "string",
"description": "e.g. 'Personal Use', 'Lease'."
},
"ownerNumber": {
"type": "number"
},
"averageMilesPerYear": {
"type": "number",
"description": "Absent on at least one real owner entry observed."
}
},
"additionalProperties": true
}
},
"iconUrl": {
"type": "null",
"description": "Always null: stripped icon-image URL."
},
"iconName": {
"type": "string"
}
},
"additionalProperties": true
},
"monthlyPaymentEstimate": {
"type": "object",
"properties": {
"price": {
"type": "number"
},
"loanAmount": {
"type": "number"
},
"interestRate": {
"type": "number"
},
"termInMonths": {
"type": "number"
},
"monthlyPayment": {
"type": "number"
},
"downPaymentAmount": {
"type": "number"
},
"downPaymentPercent": {
"type": "number"
}
},
"additionalProperties": true
}
},
"description": "Present only when the VIN has an active listing.",
"additionalProperties": true
},
"status": {
"type": "string",
"description": "'success' on the real active-listing call observed."
}
},
"description": "The listing detail result, as returned at routing.responseResultPath ($.output). A VIN with no currently active listing shapes to `{}` -- no top-level field is guaranteed present.",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.01365 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 8, 2026