# Fanfare NHL Game Schedule

> Fanfare NHL Game Schedule is a paid API for AI agents from fanfare-api.fly.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Returns NHL game matchups, period-by-period scores, and game status for a given date, defaulting to today if no date is provided.

## Facts

- Endpoint: GET https://fanfare-api.fly.dev/nhl/schedule
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fanfare-api-fly-dev-6a549349
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_47b_HrzQxa7Fyben5iH9m

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 fanfare-api-fly-dev-6a549349
```

Example prompt: What NHL games are scheduled for March 15, 2025 — show me the matchups, scores by period, and whether each game is final or still in progress.

## When to prefer this

Use this endpoint when you need NHL game schedule data, live or final scores by period, or game status for a specific date. Ideal for building sports dashboards, alerting on game outcomes, or answering user questions about tonight's or any past/future NHL slate.

## Known failure modes

- Invalid date format (not YYYY-MM-DD) may return an error or empty result
- No games scheduled for the requested date returns an empty list
- Future dates may return scheduled games without scores
- Network or upstream NHL data source outage may result in 5xx errors
- Very recent dates may have incomplete or delayed score data

## How this service works

NHL game schedule for any date — matchups, scores by period, and game status. Defaults to today's games if no date provided.

## Output

Returns a list of NHL games for the requested date, including home and away team matchups, scores broken down by period, and the current status of each game (e.g., scheduled, in progress, final). Defaults to today's games if no date is specified.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "date": "2025-03-15"
  }
 }
}
```

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "date": {
       "type": "string",
       "description": "Game date (YYYY-MM-DD)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data",
  "sport",
  "errors",
  "league",
  "warnings",
  "request_id",
  "retrieved_at"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "clock",
     "score",
     "sport",
     "league",
     "period",
     "season",
     "status",
     "date_utc",
     "away_team",
     "home_team",
     "venue_name"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "clock": {
      "type": "null"
     },
     "score": {
      "type": "object",
      "required": [
       "away",
       "home",
       "periods"
      ],
      "properties": {
       "away": {
        "type": "number"
       },
       "home": {
        "type": "number"
       },
       "periods": {
        "type": "null"
       }
      }
     },
     "sport": {
      "type": "string"
     },
     "league": {
      "type": "string"
     },
     "period": {
      "type": "number"
     },
     "season": {
      "type": "string"
     },
     "status": {
      "type": "string"
     },
     "date_utc": {
      "type": "string"
     },
     "away_team": {
      "type": "object",
      "required": [
       "id",
       "city",
       "name",
       "division",
       "full_name",
       "conference",
       "abbreviation"
      ],
      "properties": {
       "id": {
        "type": "string"
       },
       "city": {
        "type": "string"
       },
       "name": {
        "type": "string"
       },
       "division": {
        "type": "null"
       },
       "full_name": {
        "type": "string"
       },
       "conference": {
        "type": "null"
       },
       "abbreviation": {
        "type": "string"
       }
      }
     },
     "home_team": {
      "type": "object",
      "required": [
       "id",
       "city",
       "name",
       "division",
       "full_name",
       "conference",
       "abbreviation"
      ],
      "properties": {
       "id": {
        "type": "string"
       },
       "city": {
        "type": "string"
       },
       "name": {
        "type": "string"
       },
       "division": {
        "type": "null"
       },
       "full_name": {
        "type": "string"
       },
       "conference": {
        "type": "null"
       },
       "abbreviation": {
        "type": "string"
       }
      }
     },
     "venue_name": {
      "type": "string"
     }
    }
   }
  },
  "sport": {
   "type": "string"
  },
  "errors": {
   "type": "arr
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fanfare-api-fly-dev-6a549349/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fanfare-api.fly.dev](https://www.zero.xyz/host/fanfare-api.fly.dev/llms.txt)