{"uid":"cap_sRVXRCmY5BWDuFUJaXI5n","slug":"viql-vvm-compliance-eligibility-check-057d55a9","name":"VIQL VVM Compliance Eligibility Check","description":"Cited compliance eligibility verdict (checks[] + ledger provenance)","url":"https://viql.upgo.ai/viql/vvm/paid/vehicle/eligibility","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","properties":{"vin":{"type":"string","description":"Restrict verdict to one vehicle VIN"},"airport":{"type":"string","description":"3-letter IATA airport code, e.g. OAK, SFO, SJC"},"trip_date":{"type":"string","description":"YYYY-MM-DD (defaults to today, UTC)"},"passengers":{"type":"string","description":"Passenger count, 1-7"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"checks":[{"check":"airport_permit","status":"pass","citation":"OAK GT permit #123"}],"schema":"vehicle-eligibility/v1","airport":"OAK","eligible":true,"caller_id":"x402:0xPayerAddress","provenance":{"ledger_sha256":"<sha256 of compliance ledger>"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HZ8PPS4T4v4A2rU74yKCS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a compliance eligibility verdict for a vehicle (or vehicles at an airport) for a given trip date and passenger count, with cited checks and ledger provenance","exampleAgentPrompt":"Can you check if VIN 1HGBH41JXMN109186 is compliant and eligible for a rideshare trip at SFO on 2025-08-15 with 3 passengers?","exampleUseCases":[{"title":"Airport rideshare compliance check","prompt":"Is vehicle VIN 2T1BURHE0JC043821 eligible for a rideshare pickup at OAK airport tomorrow, July 18, 2025, for 2 passengers?"},{"title":"Pre-trip fleet compliance verification","prompt":"Check if VIN 5YJSA1DN5DFP14816 passes all compliance requirements for a trip at SJC on 2025-09-01 carrying 4 passengers, and show me the detailed checks and ledger provenance."},{"title":"Daily eligibility audit for a vehicle","prompt":"Run a compliance eligibility verdict for VIN 3VWFE21C04M000001 at SFO for today with 1 passenger — I need the full checks breakdown and provenance record."}],"resultDescription":"A structured eligibility verdict containing an array of compliance checks (each with citation and pass/fail status) and ledger provenance data indicating the source and traceability of the compliance determination for the specified vehicle, airport, date, and passenger count.","failureModes":["Invalid or unknown VIN returns an error or empty verdict","Invalid IATA airport code returns a validation error","Malformed trip_date format causes a 400-level error","Passenger count outside 1-7 range may be rejected","No data available for the requested date may return null or empty checks","Payment not received (x402) results in a 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when you need a cited, provenance-backed compliance verdict for vehicle eligibility at a specific airport — particularly for rideshare, TNC, or transportation network compliance workflows where auditability and ledger traceability of the result matter. Prefer this over generic vehicle lookup APIs when you need structured compliance checks rather than raw registration data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:36:25.091Z","isFirstParty":false}