endzoneapi-com Basic lookup API

The Basic lookup API from endzoneapi-com — 5 operation(s) for basic lookup.

Operations 5

POST /v1/get_standings Standings #
POST /v1/get_schedule Schedule #
POST /v1/search_players Search players #
POST /v1/get_injuries Injuries #
POST /v1/get_depth_chart Depth chart #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/endzoneapi-com:endzoneapi-com-basic-lookup-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

endzoneapi-com-basic-lookup-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: EndzoneAPI Basic lookup API
  version: 1.0.0
  description: EndzoneAPI football data. Every tool is a POST to /v1/{tool} with a JSON body of its arguments and costs the credits in x-credits. The same tools are an MCP server at https://mcp.endzoneapi.com/mcp and free accounts get credits every month at https://endzoneapi.com/signup
  termsOfService: https://endzoneapi.com/terms
  contact:
    name: EndzoneAPI support
    email: support@endzoneapi.com
    url: https://endzoneapi.com/docs
servers:
- url: https://mcp.endzoneapi.com
security:
- apiKey: []
- bearer: []
tags:
- name: Basic lookup
paths:
  /v1/get_standings:
    post:
      operationId: get_standings
      summary: Standings
      description: 'Use for regular-season standings and playoff seeding: record, win%, points for/against, home/away/division/conference records, streak, division rank, and conference seed. Ranks apply the real NFL tiebreaking procedure and report which step decided each one. Computed from final scores. Defaults to the current season. Costs 2 credits.'
      tags:
      - Basic lookup
      x-credits: 2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                season:
                  description: Season year the regular season starts (e.g. 2025). Defaults to current.
                  type:
                  - string
                  - number
                conference:
                  description: Filter by conference
                  type: string
                  enum:
                  - AFC
                  - NFC
                division:
                  description: Filter by division, e.g. 'NFC North'
                  type: string
              additionalProperties: false
      responses:
        '200':
          description: The result, wrapped in data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      season:
                        type: number
                      standings:
                        type: array
                        items:
                          type: object
                          properties:
                            team:
                              type: string
                            name:
                              type:
                              - string
                              - 'null'
                            conference:
                              type:
                              - string
                              - 'null'
                            division:
                              type:
                              - string
                              - 'null'
                            wins:
                              type: number
                            losses:
                              type: number
                            ties:
                              type: number
                            win_pct:
                              type:
                              - number
                              - 'null'
                            points_for:
                              type:
                              - number
                              - 'null'
                            points_against:
                              type:
                              - number
                              - 'null'
                            point_diff:
                              type:
                              - number
                              - 'null'
                            streak:
                              type:
                              - string
                              - 'null'
                            division_rank:
                              type:
                              - number
                              - 'null'
                            conference_rank:
                              type:
                              - number
                              - 'null'
                            division_tiebreaker:
                              type:
                              - string
                              - 'null'
                            conference_tiebreaker:
                              type:
                              - string
                              - 'null'
                          required:
                          - team
                          - wins
                          - losses
                          - ties
                          additionalProperties: {}
                      count:
                        type: number
                      note:
                        type: string
                    required:
                    - season
                    - standings
                    - count
                    additionalProperties: false
                required:
                - data
        '400':
          description: Invalid arguments.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '402':
          description: Not enough credits.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limited.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
  /v1/get_schedule:
    post:
      operationId: get_schedule
      summary: Schedule
      description: 'Use to see what is coming up: unplayed games in the next N days (default 7), or a specific week of the current season. Includes consensus lines where posted. Costs 2 credits. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.'
      tags:
      - Basic lookup
      x-credits: 2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                team:
                  description: Team code to filter
                  type: string
                week:
                  description: A specific week of the current season (returns all games that week, played or not)
                  type: integer
                  minimum: 1
                  maximum: 22
                days:
                  description: Days ahead to look when week is not set (default 7)
                  type: integer
                  minimum: 1
                  maximum: 30
              additionalProperties: false
      responses:
        '200':
          description: The result, wrapped in data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      season:
                        type: number
                      week:
                        type:
                        - number
                        - 'null'
                      days:
                        type:
                        - number
                        - 'null'
                      upcoming_games:
                        type: array
                        items:
                          type: object
                          properties:
                            game_id:
                              type: string
                            season:
                              type: number
                            week:
                              type: number
                            game_type:
                              type: string
                            home_team:
                              type: string
                            away_team:
                              type: string
                            home_score:
                              type:
                              - number
                              - 'null'
                            away_score:
                              type:
                              - number
                              - 'null'
                            status:
                              type: string
                            kickoff:
                              type:
                              - string
                              - 'null'
                            gameday:
                              type:
                              - string
                              - 'null'
                            spread_line:
                              type:
                              - number
                              - 'null'
                            total_line:
                              type:
                              - number
                              - 'null'
                            home_moneyline:
                              type:
                              - number
                              - 'null'
                            away_moneyline:
                              type:
                              - number
                              - 'null'
                            stadium:
                              type:
                              - string
                              - 'null'
                            roof:
                              type:
                              - string
                              - 'null'
                            surface:
                              type:
                              - string
                              - 'null'
                            home_qb_name:
                              type:
                              - string
                              - 'null'
                            away_qb_name:
                              type:
                              - string
                              - 'null'
                          required:
                          - game_id
                          - season
                          - week
                          - game_type
                          - home_team
                          - away_team
                          - home_score
                          - away_score
                          - status
                          - kickoff
                          additionalProperties: {}
                      count:
                        type: number
                    required:
                    - season
                    - week
                    - days
                    - upcoming_games
                    - count
                    additionalProperties: false
                required:
                - data
        '400':
          description: Invalid arguments.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '402':
          description: Not enough credits.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limited.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
  /v1/search_players:
    post:
      operationId: search_players
      summary: Search players
      description: Use to find a player by name (partial match). Searches ~25,000 players back to 1999; returns current-season players by default, falling back to all players back to 1999 when none match. Returns the GSIS player id needed by get_player_stats. Costs 2 credits.
      tags:
      - Basic lookup
      x-credits: 2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  minLength: 1
                  description: Player name or part of it
                team:
                  description: Filter by current team code
                  type: string
                position:
                  description: Filter by position (e.g. QB, RB, WR, TE, OL, DL, LB, DB)
                  type: string
                active:
                  description: Default true, but an active-only search that finds nobody automatically falls back to all players and says so. Set false to search everyone outright.
                  type: boolean
                limit:
                  description: Max results (default 10)
                  type: integer
                  minimum: 1
                  maximum: 50
              required:
              - query
              additionalProperties: false
      responses:
        '200':
          description: The result, wrapped in data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      players:
                        type: array
                        items:
                          type: object
                          properties:
                            player_id:
                              type:
                              - string
                              - 'null'
                            name:
                              type:
                              - string
                              - 'null'
                            position:
                              type:
                              - string
                              - 'null'
                            team:
                              type:
                              - string
                              - 'null'
                            active:
                              type:
                              - boolean
                              - 'null'
                            pfr_id:
                              type:
                              - string
                              - 'null'
                            espn_id:
                              type:
                              - string
                              - 'null'
                          additionalProperties: {}
                      count:
                        type: number
                      included_inactive:
                        type: boolean
                      note:
                        type: string
                    required:
                    - players
                    - count
                    - included_inactive
                    additionalProperties: false
                required:
                - data
        '400':
          description: Invalid arguments.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '402':
          description: Not enough credits.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limited.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
  /v1/get_injuries:
    post:
      operationId: get_injuries
      summary: Injuries
      description: 'Use for the official injury report: game status (Out, Doubtful, Questionable) and practice participation with the injury named, by team and week. Defaults to the latest reported week of the current season. Costs 2 credits.'
      tags:
      - Basic lookup
      x-credits: 2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                team:
                  description: Team code
                  type: string
                season:
                  description: Season year. Defaults to current.
                  type:
                  - string
                  - number
                week:
                  description: Week. Defaults to the latest week with a report.
                  type: integer
                  minimum: 1
                  maximum: 22
                status:
                  description: 'Filter by game status: Out, Doubtful, Questionable'
                  type: string
              additionalProperties: false
      responses:
        '200':
          description: The result, wrapped in data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      season:
                        type: number
                      week:
                        type: number
                      injuries:
                        type: array
                        items:
                          type: object
                          properties:
                            team:
                              type:
                              - string
                              - 'null'
                            player_id:
                              type:
                              - string
                              - 'null'
                            name:
                              type:
                              - string
                              - 'null'
                            position:
                              type:
                              - string
                              - 'null'
                            report_status:
                              type:
                              - string
                              - 'null'
                            report_primary_injury:
                              type:
                              - string
                              - 'null'
                            practice_status:
                              type:
                              - string
                              - 'null'
                          additionalProperties: {}
                      count:
                        type: number
                      note:
                        type: string
                    required:
                    - season
                    - week
                    - injuries
                    - count
                    additionalProperties: false
                required:
                - data
        '400':
          description: Invalid arguments.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '402':
          description: Not enough credits.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limited.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
  /v1/get_depth_chart:
    post:
      operationId: get_depth_chart
      summary: Depth chart
      description: 'Use for a team''s depth chart by week: formation, position, depth rank, player. Defaults to the latest week available. Costs 2 credits.'
      tags:
      - Basic lookup
      x-credits: 2
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                team:
                  type: string
                  description: Team code
                season:
                  description: Season year. Defaults to current.
                  type:
                  - string
                  - number
                week:
                  description: Week. Defaults to latest.
                  type: integer
                  minimum: 1
                  maximum: 22
                formation:
                  description: Filter by formation/unit, e.g. Offense, Defense, Special Teams
                  type: string
              required:
              - team
              additionalProperties: false
      responses:
        '200':
          description: The result, wrapped in data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      team:
                        type: string
                      season:
                        type: number
                      week:
                        type: number
                      depth_chart:
                        type: array
                        items:
                          type: object
                          properties:
                            formation:
                              type:
                              - string
                              - 'null'
                            position:
                              type:
                              - string
                              - 'null'
                            depth_rank:
                              type:
                              - number
                              - 'null'
                            player_id:
                              type:
                              - string
                              - 'null'
                            name:
                              type:
                              - string
                              - 'null'
                          additionalProperties: {}
                      count:
                        type: number
                    required:
                    - team
                    - season
                    - week
                    - depth_chart
                    - count
                    additionalProperties: false
                required:
                - data
        '400':
          description: Invalid arguments.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '402':
          description: Not enough credits.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limited.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
    bearer:
      type: http
      scheme: bearer
      description: The same API key as a bearer token.
externalDocs:
  description: Documentation
  url: https://endzoneapi.com/docs