---
title: "GET /teams/"
method: GET
path: "/teams/"
tags: ["Teams"]
---

# GET /teams/

`GET /teams/`

Get a list of Teams by ID or league

## Query parameters

- `sportID` string
- `leagueID` string
- `teamID` string
- `limit` number
- `cursor` string

## Response `200`

An array of teams with pagination

- object
  - `data` Team[]
    - `sportID` string
    - `leagueID` string
    - `teamID` string
    - `logo` string
    - `names` object
      - `short` string
      - `medium` string
      - `long` string
    - `colors` object
      - `primary` string
      - `secondary` string
      - `primaryContrast` string
      - `secondaryContrast` string
    - `standings` object
      - `position` string
      - `wins` number
      - `losses` number
      - `ties` number
      - `record` string
      - `played` number
    - `lookups` object
      - `teamName` string[]
  - `nextCursor` string
  - `success` boolean

## Other responses

- `400` — Invalid params
- `401` — Invalid API key
- `403` — Inactive API key
- `404` — No teams found
- `429` — Rate limit exceeded
- `500` — Query failed

---

[API](https://skmtc.net/sportsgameodds/apis/sports-game-odds-api.md) · [All operations](https://skmtc.net/sportsgameodds/apis/sports-game-odds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sportsgameodds/sports-game-odds-api/revisions/37767db05cc7/schema)