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. Toyota, Honda, Ford, BMW, Subaru)."
},
"page": {
"type": "integer",
"description": "Page number for pagination (1-based)."
},
"rows": {
"type": "integer",
"description": "Number of results per page (max 100)."
},
"sort": {
"type": "string",
"description": "Sort order for results."
},
"trim": {
"type": "string",
"description": "Trim level filter matching the site's Trim facet for the selected model, written exactly as CARFAX lists it (case-sensitive, e.g. LE, XSE, Unspecified). Several trims may be combined as a comma-separated list (e.g. LE,XSE) to match any of them. Omit to return all trims."
},
"model": {
"type": "string",
"description": "Vehicle model to filter by (e.g. Camry, Civic, F-150). Must correspond to the specified make."
},
"radius": {
"type": "integer",
"description": "Search radius in miles from the ZIP code."
},
"year_max": {
"type": "string",
"description": "Latest model year to include, inclusive, as a 4-digit year (YYYY). May be used alone or with year_min; must not be less than year_min. Omit for no upper bound."
},
"year_min": {
"type": "string",
"description": "Earliest model year to include, inclusive, as a 4-digit year (YYYY). May be used alone or with year_max. Omit for no lower bound."
},
"exterior_color": {
"type": "string",
"description": "Exterior color filter as a color name, matching the site's Exterior Color facet; observed values include Black, Gray, White, Silver, Blue, Red, Beige, Green, Gold, Unspecified. Case-insensitive. Several colors may be combined as a comma-separated list (e.g. Gray,Red) to match any of them. Omit to return all colors."
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "The requested page number, echoed back."
},
"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",
"description": "e.g. 'document_fee', 'Dealer Service Charge +Title Service Fee'."
}
},
"additionalProperties": true
},
"description": "Itemized dealer fees, observed 2-3 per listing."
},
"fuel": {
"type": "string",
"description": "e.g. 'Gasoline', 'Hybrid'."
},
"make": {
"type": "string"
},
"trim": {
"type": "string"
},
"year": {
"type": "number"
},
"badge": {
"type": "string",
"description": "CARFAX's own deal-quality label, 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"
},
"showroom": {
"type": "boolean",
"description": "Only present on some listings."
},
"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."
},
"dealerReviewReviewer": {
"type": "string",
"description": "An anonymized reviewer handle built from the reviewer's own vehicle, e.g. '2019 TOYOTA RAV4 LE Owner' -- not a personal name on any real listing observed."
},
"dealerBadgingExperience": {
"type": "string",
"description": "e.g. 'TOPRATED', 'ADVANTAGE' -- a trust badge CARFAX assigns to the dealer."
}
},
"description": "The selling dealership's own public business listing -- not a private individual (see verification.notes).",
"additionalProperties": true
},
"engine": {
"type": "string",
"description": "e.g. '4 Cyl', '6 Cyl'."
},
"cabType": {
"type": "string",
"description": "'Unspecified' on non-truck body types."
},
"cpoData": {
"type": "object",
"properties": {
"cpo_body": {
"type": "string"
},
"make_name": {
"type": "string",
"description": "The CPO program's manufacturer name."
},
"cpo_header": {
"type": "string"
},
"cpo_bullet_1": {
"type": "string"
},
"cpo_bullet_2": {
"type": "string"
},
"cpo_bullet_3": {
"type": "string"
}
},
"description": "Certified pre-owned program details. Only present when `certified` is true; never observed on a non-CPO listing.",
"additionalProperties": true
},
"mileage": {
"type": "number"
},
"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'."
},
"oneOwner": {
"type": "boolean"
},
"onePrice": {
"type": "number",
"description": "CARFAX's own 'MyPrice' estimate in USD, distinct from the dealer's listed price."
},
"bedLength": {
"type": "string",
"description": "'Unspecified' on non-truck body types."
},
"certified": {
"type": "boolean",
"description": "Whether this is a certified pre-owned vehicle. Only present on listings that are CPO -- not present on every listing."
},
"drivetype": {
"type": "string",
"description": "e.g. 'FWD', 'AWD'."
},
"firstSeen": {
"type": "string",
"description": "Date this listing was first seen, e.g. '2026-07-29'."
},
"listPrice": {
"type": "number",
"description": "USD."
},
"allInPrice": {
"type": "boolean",
"description": "Whether the listed price already includes dealer fees."
},
"dealerType": {
"type": "string",
"description": "e.g. 'NEW', 'USED' -- whether the selling dealer is a new-car franchise or independent used-car lot."
},
"imageCount": {
"type": "number"
},
"mpgHighway": {
"type": "number"
},
"topOptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "A short, dealer-curated list of highlighted features."
},
"mpgCombined": {
"type": "number"
},
"noAccidents": {
"type": "boolean"
},
"personalUse": {
"type": "boolean",
"description": "Not present on every listing (e.g. absent on a rental-use vehicle)."
},
"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": "A percentile ranking, e.g. 50."
},
"overallReliabilityBadge": {
"type": "string",
"description": "e.g. 'GOOD'."
},
"reliabilityImpactFactors": {
"type": "array",
"items": {
"type": "string"
},
"description": "Short factor codes, e.g. 'TOP_50_ISR'."
}
},
"description": "CARFAX's own reliability rating for this model. Not present on every listing.",
"additionalProperties": true
},
"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, e.g. 'Hybrid', 'High Demand'. Not observed on every listing."
},
"currentPrice": {
"type": "number",
"description": "USD; equal to listPrice on both real listings observed."
},
"displacement": {
"type": "string",
"description": "e.g. '2.5 L'."
},
"ownerHistory": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'CARFAX 1-Owner'."
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "The prior owner's city, at city-level granularity only (see verification.notes)."
},
"state": {
"type": "string"
},
"ownerNumber": {
"type": "number"
},
"purchaseDate": {
"type": "string"
},
"endOwnershipDate": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"transmission": {
"type": "string"
},
"vehiclePrice": {
"type": "number",
"description": "USD; a third price figure distinct from listPrice/onePrice, observed lower than listPrice on real listings."
},
"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": "Only present on some factor entries."
},
"descriptiveText": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"description": "A more detailed, human-readable version of the reliability rating. Observed alongside `reliability` on the same listings that have it, never in place of it.",
"additionalProperties": true
},
"atomTopOptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "A short, normalized list of headline features."
},
"serviceHistory": {
"type": "object",
"properties": {
"text": {
"type": "string"
},
"number": {
"type": "number",
"description": "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 business's name and location, e.g. 'Take 5 Oil Change, Palos Heights, IL, '."
},
"description": {
"type": "string"
},
"odometerReading": {
"type": "number"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"serviceRecords": {
"type": "boolean"
},
"accidentHistory": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'No Accident or Damage Reported', 'Accident/No Damage'."
},
"accidentSummary": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": true
},
"atomOtherOptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "The vehicle's full factory/dealer feature and equipment list, often 100+ entries."
},
"distanceToDealer": {
"type": "number",
"description": "Miles from the searched ZIP code."
},
"vehicleCondition": {
"type": "string",
"description": "'Used' on every real listing observed."
},
"vehicleUseHistory": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "e.g. 'Personal Use', 'Rental Use'."
},
"history": {
"type": "array",
"items": {
"type": "object",
"properties": {
"useType": {
"type": "string"
},
"ownerNumber": {
"type": "number"
},
"averageMilesPerYear": {
"type": "number"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"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 vehicle, 0 to `totalListingCount` observed. Empty when nothing currently for sale matches the search."
},
"searchArea": {
"type": "object",
"properties": {
"zip": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"radius": {
"type": "number",
"description": "Miles, echoing the requested (or default) radius."
},
"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
},
"totalPageCount": {
"type": "number",
"description": "Total number of pages at the requested page size."
},
"totalListingCount": {
"type": "number",
"description": "Total number of listings matching the search criteria, which can exceed the number of listings actually included in this response (440 total vs. 10 returned on the Camry fixture) -- this endpoint returns a single page at a time."
}
},
"additionalProperties": true
},
"status": {
"type": "string",
"description": "'success' on both real calls observed, including the zero-match case."
}
},
"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 8, 2026