---
title: "List teams"
method: POST
path: "/v1/list_teams"
tags: ["Static reference"]
---

# List teams

`POST /v1/list_teams`

## Request

- Base URL: `https://mcp.endzoneapi.com`
- URL: `https://mcp.endzoneapi.com/v1/list_teams`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use when you need team codes, or all 32 current teams with conference, division, colours, and logo URLs. Team codes are standard abbreviations (LA for the Rams, WAS for Washington). Cheapest tool at 1 credit.

## Request body

- object
  - `conference` 'AFC' | 'NFC': Filter by conference
  - `division` string: Filter by division, e.g. 'AFC East' or 'NFC West'

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `teams` object[], required
      - `abbrev` string, required
      - `name` string, nullable
      - `conference` string, nullable
      - `division` string, nullable
      - `logo` string, nullable
    - `count` number, required

## Other responses

- `400`: Invalid arguments.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `429`: Rate limited.

---

[API](https://skmtc.dev/endzoneapi/apis/endzoneapi-api.md) · [All operations](https://skmtc.dev/endzoneapi/apis/endzoneapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/endzoneapi/apis/endzoneapi-api/revisions/14fa4d187e75?raw)
