Multi-table

Head to head

Use when comparing two teams' history. Returns recent matchups with win/loss record. Can filter by season or get all-time. Costs 10 credits.

post/v1/get_head_to_head

Request

  • Base URL: https://mcp.puckapi.com
  • URL: https://mcp.puckapi.com/v1/get_head_to_head
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

team1string required

First team abbreviation (e.g. BUF)

team2string required

Second team abbreviation (e.g. TOR)

seasonstring

Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Omit for all-time.

limitinteger

Max games to return (default 20)

league'nhl' | 'pwhl' | 'ohl' | 'whl' | 'qmjhl' | 'echl' | 'ahl' | 'ushl'

League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl.

Response

The result, wrapped in data.

Changes

No recorded changes to this operation across all 1 revision of this API.