# VIQL VVM Compliance Eligibility Check

> VIQL VVM Compliance Eligibility Check is a paid API for AI agents from viql.upgo.ai, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

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

## Facts

- Endpoint: GET https://viql.upgo.ai/viql/vvm/paid/vehicle/eligibility
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/viql-vvm-compliance-eligibility-check-057d55a9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sRVXRCmY5BWDuFUJaXI5n

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability viql-vvm-compliance-eligibility-check-057d55a9
```

Example prompt: Can you check if VIN 1HGBH41JXMN109186 is compliant and eligible for a rideshare trip at SFO on 2025-08-15 with 3 passengers?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Cited compliance eligibility verdict (checks[] + ledger provenance)

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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>"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/viql-vvm-compliance-eligibility-check-057d55a9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from viql.upgo.ai](https://www.zero.xyz/host/viql.upgo.ai/llms.txt)