NFL Team vs. Opponent

GET

/v1/nfl/team-vs-opponent

Last modified:2026-10-16 02:10:05

A team's history against one opponent, with totals and per-game averages.

Cost: 3 request units per call.

Rules

Team and opponent must be different.

Since must be the same as or earlier than Through.

Season must fall between Since and Through.

Related: NFL Player vs. Opponent (/v1/nfl/player-vs-opponent)

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

API Key

Add parameter in query

api_key

Example:

api_key: ********************

Query Params

🟢200

application/json

Success

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠429RateLimited

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/nfl/team-vs-opponent?team=&opponent=&season=&since=&through=&season_type=&venue=&limit=' \
--header 'x-api-key: <api-key>'

Response Example

200 - Example 1

{}

Modified at 2026-10-16 02:10:05