Contract
input_schema.json
{
"type": "object",
"anyOf": [
{
"required": [
"zip"
]
},
{
"required": [
"make"
]
},
{
"required": [
"model"
]
}
],
"properties": {
"zip": {
"type": "string",
"description": "5-digit US ZIP code for search location."
},
"make": {
"type": "string",
"description": "Vehicle make to filter by (e.g. Honda, Toyota, Ford)."
},
"model": {
"type": "string",
"description": "Vehicle model to filter by (e.g. Civic, Camry, F-150). Must correspond to the specified make."
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"vin": {
"type": "string"
},
"fees": {
"type": "array",
"items": {
"type": "object",
"properties": {
"fee": {
"type": "number",
"description": "USD."
},
"feeType": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Itemized dealer fees."
},
"fuel": {
"type": "string",
"description": "e.g. 'Gasoline', 'Hybrid'."
},
"make": {
"type": "string"
},
"msrp": {
"type": "number",
"description": "Manufacturer's suggested retail price, USD."
},
"trim": {
"type": "string"
},
"year": {
"type": "number"
},
"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"
},
"longitude": {
"type": "string"
},
"businessHours": {
"type": [
"string",
"null"
],
"description": "Observed `null` on every real listing captured -- structured hours were never seen populated."
},
"dealerReviewDate": {
"type": "string"
},
"dealerReviewCount": {
"type": "number"
},
"dealerReviewRating": {
"type": "number"
},
"dealerAverageRating": {
"type": "number"
},
"dealerReviewComments": {
"type": "string",
"description": "Free-text customer review of the dealership, displayed publicly by CARFAX."
},
"dealerReviewReviewer": {
"type": "string",
"description": "Sometimes an anonymized vehicle-owner handle (e.g. '2022 HONDA PASSPORT TRAIL SPORT Owner'), but real listings also showed a first name plus last initial (e.g. 'Debbie P.') -- the reviewer attribution CARFAX itself displays publicly on its own dealer review page (see dealer.cfxMicrositeUrl in the raw response). See verification.notes."
},
"dealerBadgingExperience": {
"type": "string",
"description": "e.g. 'TOPRATED' -- a trust badge assigned to the dealer."
}
},
"description": "The selling dealership's own public business listing -- not a private individual.",
"additionalProperties": true
},
"engine": {
"type": "string",
"description": "e.g. '4 Cyl'."
},
"cabType": {
"type": "string",
"description": "'Unspecified' on non-truck body types."
},
"mileage": {
"type": "number",
"description": "Typically 0 or near-0 for a new vehicle."
},
"mpgCity": {
"type": "number"
},
"subTrim": {
"type": "string",
"description": "e.g. 'Unspecified' when the site has no finer trim breakdown."
},
"bodytype": {
"type": "string",
"description": "e.g. 'Sedan'."
},
"bedLength": {
"type": "string",
"description": "'Unspecified' on non-truck body types."
},
"drivetype": {
"type": "string",
"description": "e.g. 'FWD', 'AWD'."
},
"listPrice": {
"type": "number",
"description": "USD."
},
"allInPrice": {
"type": "boolean",
"description": "Whether the listed price already includes dealer fees."
},
"dealerType": {
"type": "string",
"description": "e.g. 'NEW' -- a new-car franchise dealer."
},
"imageCount": {
"type": "number"
},
"mpgHighway": {
"type": "number"
},
"topOptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "A short, dealer-curated list of highlighted features."
},
"mpgCombined": {
"type": "number"
},
"stockNumber": {
"type": "string",
"description": "The selling dealer's own internal inventory stock number."
},
"chicletBadge": {
"type": "string",
"description": "A short marketing badge shown alongside the listing. Not present on every listing."
},
"currentPrice": {
"type": "number",
"description": "USD; equal to listPrice on every real listing observed."
},
"displacement": {
"type": "string",
"description": "e.g. '2.0 L'."
},
"priceHistory": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "e.g. '09/09/2026'."
},
"listPrice": {
"type": "number"
},
"difference": {
"type": "number",
"description": "Change from the prior snapshot, USD."
}
},
"additionalProperties": true
},
"description": "Prior list-price snapshots for this listing. Only present on a listing with at least one price change -- absent, not an empty array, on the rest."
},
"transmission": {
"type": "string"
},
"vehiclePrice": {
"type": "number",
"description": "USD; a second price figure, distinct from listPrice on real listings."
},
"exteriorColor": {
"type": "string"
},
"interiorColor": {
"type": "string"
},
"listingStatus": {
"type": "string",
"description": "e.g. 'PRICE DROP'. Not present on every listing."
},
"atomTopOptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "A short, normalized list of headline features."
},
"atomOtherOptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "The vehicle's fuller factory/dealer feature list."
},
"distanceToDealer": {
"type": "number",
"description": "Miles from the searched ZIP code."
},
"vehicleCondition": {
"type": "string",
"description": "'New' on every real listing observed."
},
"monthlyPaymentEstimate": {
"type": "object",
"properties": {
"price": {
"type": "number"
},
"loanAmount": {
"type": "number"
},
"interestRate": {
"type": "number",
"description": "Percent APR."
},
"termInMonths": {
"type": "number"
},
"monthlyPayment": {
"type": "number"
},
"downPaymentAmount": {
"type": "number"
},
"downPaymentPercent": {
"type": "number"
}
},
"description": "An estimated financing breakdown for this vehicle at its list price.",
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "One entry per matching new vehicle."
},
"searchArea": {
"type": "object",
"properties": {
"zip": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"radius": {
"type": "number",
"description": "Miles, e.g. 50."
},
"latitude": {
"type": "number"
},
"longitude": {
"type": "number"
},
"dynamicRadii": {
"type": "array",
"items": {
"type": "number"
},
"description": "Alternate radii the site itself suggests trying, widest first, e.g. [50, 100, 200]."
}
},
"description": "The resolved search location for the given ZIP code.",
"additionalProperties": true
},
"totalListingCount": {
"type": "number",
"description": "Total number of listings matching the search criteria, which can exceed the number of listings actually included in this response (1,063 total vs. far fewer returned on the Civic fixture) -- this endpoint returns a single page at a time."
}
},
"additionalProperties": true
},
"status": {
"type": "string",
"description": "'success' on both real calls observed."
}
},
"description": "The listings search result, as returned at routing.responseResultPath ($.output).",
"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 23, 2026