# Agent Weather Provider Health Decision

> Agent Weather Provider Health Decision is a paid API for AI agents from api.agentweather.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-17).

Returns a go/caution/no-go operational health decision for a named AI provider, based on their public status page readings and 24h/7d incident history, paid via x402.

## Facts

- Endpoint: GET https://api.agentweather.io/v1/decide/provider-health?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-weather-provider-health-decision-c82996de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ovenNqOyWblJCX4_mJIB2

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 agent-weather-provider-health-decision-c82996de
```

Example prompt: Before we kick off the next pipeline run, check if Anthropic is healthy right now — give me a go, caution, or no-go decision along with any active incidents and how disturbed it's been over the last 24 hours.

## When to prefer this

Choose this endpoint when an agent needs a structured, actionable go/caution/no-go decision for a specific AI provider before making API calls or routing workloads. It is preferable over raw status-page scraping because it normalizes multi-source readings into a single decision enum with 24h history, requires no API key, and works with x402 micropayments. Use it for pre-flight checks in automated pipelines where switching to a fallback model should be triggered programmatically rather than manually.

## Known failure modes

- No free JSON status source available for the requested provider → decision: unknown
- Last successful check older than 30 minutes → decision: unknown
- Invalid or unrecognized provider slug → error response
- Payment not provided → 402 with PAYMENT-REQUIRED header and fresh invoiceId
- Payment verification failure → payment rejected, no data returned
- Facilitator or ledger settlement failure → payment not confirmed, request not fulfilled

## How this service works

AI provider health reading for one provider (GET /v1/decide/provider-health?provider=anthropic; a model id also works): the vendor's own status-page indicator and active incidents, the share of disturbed checks in the last 24h of our record (checked every 10 min), and a reading field (go, caution, …

## Output

A JSON object containing a health decision string (go, caution, no-go, or unknown), a recommended action (proceed, proceed_with_fallback_ready, switch_to_fallback, verify_yourself), a plain-English summary of active incidents and current status, 24-hour disturbance history (total checks, disturbed share, last indicator change), the provider slug, and an issued_at timestamp. A disclaimer and terms URL are also included.

## 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "provider"
     ],
     "properties": {
      "provider": {
       "type": "string",
       "description": "vendor slug or model id"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "decision",
      "go",
      "action",
      "summary"
     ],
     "properties": {
      "go": {},
      "action": {},
      "summary": {},
      "decision": {}
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "go": null,
  "kind": "pre-flight conditions reading: AI provider",
  "rules": {
   "action": "go→proceed, caution→proceed_with_fallback_ready, no_go→switch_to_fallback, unkn…",
   "decision": "go = vendor status operational; caution = minor or maintenance; no_go = major o…"
  },
  "terms": "https://api.agentweather.io/v1/terms",
  "action": "proceed_with_fallback_ready",
  "summary": "anthropic: caution (minor: Partially Degraded Service); 1 active incident(s); d…",
  "decision": "caution",
  "provider": "anthropic",
  "issued_at": "2026-10-13T06:36:10.470Z",
  "disclaimer": "Recorded measurements as of issued_at; may be late, incomplete or wrong; not fi…",
  "history_24h": {
   "checks": 38,
   "window": "last 24h",
   "formulas": {
    "disturbed_share": "checks with indicator ≠ none ÷ successful checks in the window (each check is o…"
   },
   "disturbed_share": 1,
   "disturbed_checks": 38,
   "successful_checks": 38,
   "last_indicator_change": null
  },
  "schema_version": "decide-0.1.0-draft"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-weather-provider-health-decision-c82996de/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentweather.io](https://www.zero.xyz/host/api.agentweather.io/llms.txt)