---
title: "Get a team"
method: GET
path: "/v1/teams/{team_id}"
tags: ["teams"]
---

# Get a team

`GET /v1/teams/{team_id}`

## Request

- Base URL: `https://lumify.ai`
- URL: `https://lumify.ai/v1/teams/{team_id}`
- Auth: HTTP bearer

## Path parameters

- `team_id` integer, required: Lumify team ID

## Response `200`

Team profile with home venue.

- Team
  - `id` integer, nullable
  - `slug` string, nullable
  - `name` string, nullable
  - `short_name` string, nullable
  - `abbreviation` string, nullable
  - `image_url` string, nullable: Lumify media URL for the team logo (e.g. https://lumify.ai/media/teams/mlb/70.png). Null until the logo ingest job has published the asset. Never a vendor CDN or raw GCS URL.
  - `sport` string, nullable
  - `league` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `country_code` string, nullable
  - `conference` string, nullable
  - `division` string, nullable
  - `venue` object, nullable
  - `is_active` boolean, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lumify/apis/lumify-sports-intelligence-api.md) · [All operations](https://skmtc.dev/lumify/apis/lumify-sports-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lumify/apis/lumify-sports-intelligence-api/revisions/f91ea41a2606?raw)