# Zeroclass Award Deal Query

> Zeroclass Award Deal Query is a paid API for AI agents from zeroclass.pay.zeroclick.io, paid per call via MPP or x402, $0.15/call, status unknown (last checked 2026-10-13, last successful call 2026-10-12).

Returns graded, percentile-ranked award flight deals for a given origin/destination corridor and cabin class, with personalized point-cost paths based on your loyalty currencies.

## Facts

- Endpoint: GET https://zeroclass.pay.zeroclick.io/v1/deals?utm_source=zero.xyz
- Price: $0.15/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-13
- Last successful call: 2026-10-12
- Success rate: 100% of calls made through Zero
- Rating: 4.3 / 5 from 1 review
- Activations on Zero: 1
- Provider: zeroclass.pay.zeroclick.io
- Website: https://zeroclass.pay.zeroclick.io
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zeroclass-pay-zeroclick-io-zeroclass-award-deal-query-e251517b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xspG9X26DZjcdG_F0UeoE

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 zeroclass-pay-zeroclick-io-zeroclass-award-deal-query-e251517b
```

Example prompt: Find the best graded business class award deals from SFO and LAX to Tokyo (NRT or HND) — I have Amex MR and Chase UR points, so personalize the results to those currencies.

## When to prefer this

Choose this endpoint when you need on-demand, graded award deal intelligence for a specific flight corridor and cabin — especially when you want to know not just what's available but how good the deal is relative to historical norms (90-day percentile). Prefer it over generic flight search when the user holds specific loyalty currencies and wants personalized point costs and transfer paths. It is particularly valuable for agents automating award travel research or monitoring for exceptional redemption opportunities.

## Known failure modes

- 402 Payment Required — request is unsigned or payment not settled; must resolve x402/MPP challenge and retry
- 202 Accepted with retry_after — cached data is stale (>3h) and a fresh scan has been triggered; agent must poll after the indicated delay
- No deals returned — corridor has no award availability matching the filters or specified currencies cannot reach any available deals
- Invalid airport codes — malformed or unrecognized IATA codes in origins or destinations
- Invalid cabin enum — value other than 'business' or 'first' supplied

## How this service works

Pay-per-call: meter deal_query, $0.15 (service zeroclass). Unsigned/unpaid → 402 x402/MPP challenge; settle and retry. Served from cache when fresh (<3h), else 202 + retry_after while a scan runs. Each deal carries a grade + trailing-90d percentile.

## Output

A list of award deals for the requested corridor and cabin, each carrying a quality grade and trailing-90-day percentile score. When currencies are provided, results include a personalized point cost (your_price) and transfer path (your_path), filtering out deals unreachable with your holdings. Results are served from cache if fresh (under 3 hours); otherwise a 202 response with retry_after is returned while a live scan runs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "origins",
  "destinations"
 ],
 "properties": {
  "cabin": {
   "enum": [
    "business",
    "first"
   ],
   "type": "string",
   "description": "Cabin: business or first."
  },
  "origins": {
   "type": "string",
   "description": "Comma-separated origin airport codes (e.g. SFO,LAX)."
  },
  "currencies": {
   "type": "string",
   "description": "Optional comma-separated bank currencies you hold (amex-mr,chase-ur,citi-ty,capital-one,bilt,wells-fargo,marriott) → personalized your_price/your_path; unreachable deals dropped."
  },
  "destinations": {
   "type": "string",
   "description": "Comma-separated destination airport codes (e.g. NRT,HND)."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zeroclass-pay-zeroclick-io-zeroclass-award-deal-query-e251517b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from zeroclass.pay.zeroclick.io](https://www.zero.xyz/host/zeroclass.pay.zeroclick.io/llms.txt)