# Fanfare NBA Teams List

> Fanfare NBA Teams List is a paid API for AI agents from fanfare-api.fly.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns all 30 NBA teams with their ID, city, abbreviation, conference, and division for use in further queries.

## Facts

- Endpoint: GET https://fanfare-api.fly.dev/nba/teams
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fanfare-api-fly-dev-675f0b50
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V_plx5kl8B0WvdZyzaWU4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability fanfare-api-fly-dev-675f0b50
```

Example prompt: Give me a list of all 30 NBA teams with their IDs, abbreviations, conferences, and divisions so I can look up schedules for Eastern Conference teams.

## When to prefer this

Use this endpoint as the first step when building NBA data workflows — it provides the canonical team IDs and abbreviations needed to query schedules, standings, or arena information. Prefer this over hardcoding team IDs or scraping Wikipedia when you need reliable, structured team metadata.

## Known failure modes

- Service unavailable (5xx) if the fly.dev host is down or sleeping
- Payment required (402) if the x402 micropayment header is missing or invalid
- Unexpected empty or malformed response if the upstream data source is stale

## How this service works

All 30 NBA teams with ID, city, abbreviation, conference, and division. Use team IDs to query schedules and standings.

## Output

A structured list of all 30 NBA teams, each with a unique team ID, city name, team abbreviation (e.g. LAL, GSW), conference (Eastern or Western), and division (e.g. Pacific, Atlantic). Team IDs can be used as input to schedule and standings endpoints.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data",
  "sport",
  "errors",
  "league",
  "warnings",
  "request_id",
  "retrieved_at"
 ],
 "properties": {
  "data": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "city",
     "name",
     "record",
     "division",
     "full_name",
     "conference",
     "abbreviation",
     "division_rank",
     "conference_rank"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "city": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "record": {
      "type": "null"
     },
     "division": {
      "type": "null"
     },
     "full_name": {
      "type": "string"
     },
     "conference": {
      "type": "null"
     },
     "abbreviation": {
      "type": "string"
     },
     "division_rank": {
      "type": "null"
     },
     "conference_rank": {
      "type": "null"
     }
    }
   }
  },
  "sport": {
   "type": "string"
  },
  "errors": {
   "type": "array",
   "items": {
    "type": "unknown"
   }
  },
  "league": {
   "type": "string"
  },
  "warnings": {
   "type": "array",
   "items": {
    "type": "unknown"
   }
  },
  "request_id": {
   "type": "string"
  },
  "retrieved_at": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fanfare-api-fly-dev-675f0b50/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fanfare-api.fly.dev](https://www.zero.xyz/host/fanfare-api.fly.dev/llms.txt)