# Major Domo - API Reference

## Authentication

All write operations require Bearer token:
```bash
export API_TOKEN='your-token-here'
```

## Environments

- **Production**: `https://api.sba.manticorum.com/v3/`
- **Development**: `http://10.10.0.42:8000/api/v3/`

```bash
export DATABASE='prod'  # or 'dev'
```

## Endpoints

### Current Status
- `GET /current` - Current season/week status
- `GET /current?season={N}` - Specific season status
- `PATCH /current/{id}` - Update status (private)

### Players
- `GET /players?season={N}` - List all players in season
- `GET /players?team_id={id}` - Players by team
- `GET /players?name={name}` - Players by name (exact)
- `GET /players/search?q={query}` - Fuzzy search
- `GET /players/{id}` - Single player
- `PATCH /players/{id}` - Update player (private)

### Teams
- `GET /teams?season={N}` - List teams
- `GET /teams?team_abbrev={abbrev}` - By abbreviation
- `GET /teams?active_only=true` - Active teams only
- `GET /teams/{id}` - Single team
- `GET /teams/{id}/roster/{which}` - Roster (current/next)

### Standings
- `GET /standings?season={N}` - All standings
- `GET /standings?season={N}&division_abbrev={div}` - By division
- `GET /standings/team/{team_id}` - Single team
- `POST /standings/s{season}/recalculate` - Recalculate (private)

### Transactions
- `GET /transactions?season={N}` - List transactions
- `GET /transactions?season={N}&team_abbrev={abbrev}` - By team
- `GET /transactions?season={N}&week_start={W}&week_end={W}` - By week range
- `PATCH /transactions/{move_id}` - Update (private)

### Statistics (Advanced Views)
- `GET /views/season-stats/batting?season={N}` - Season batting
  - Params: `team_id`, `player_id`, `min_pa`, `sort_by`, `sort_order`, `limit`, `offset`
- `GET /views/season-stats/pitching?season={N}` - Season pitching
  - Params: `team_id`, `player_id`, `min_outs`, `sort_by`, `sort_order`, `limit`, `offset`
- `POST /views/season-stats/batting/refresh` - Refresh batting (private)
- `POST /views/season-stats/pitching/refresh` - Refresh pitching (private)

### Other Endpoints
- `/api/v3/schedules` - Game scheduling
- `/api/v3/results` - Game results
- `/api/v3/injuries` - Injury tracking
- `/api/v3/awards` - League awards
- `/api/v3/managers` - Manager profiles
- `/api/v3/divisions` - Division info
- `/api/v3/draftdata` - Draft status
- `/api/v3/draftpicks` - Pick ownership
- `/api/v3/draftlist` - Draft priority lists
- `/api/v3/keepers` - Keeper selections
- `/api/v3/stratgame` - Game data
- `/api/v3/stratplay` - Play-by-play
- `/api/v3/sbaplayers` - Player pool
- `/api/v3/custom_commands` - Custom Discord commands
- `/api/v3/help_commands` - Static help text

## Python API Client

```python
from api_client import MajorDomoAPI

api = MajorDomoAPI(environment='prod', verbose=True)
# Or: api = MajorDomoAPI(environment='dev', token='your-token')

# Common operations
current = api.get_current()
team = api.get_team(abbrev='CAR')
player = api.get_player(name='Mike Trout', season=12)
results = api.search_players(query='trout', season=12, limit=10)
roster = api.get_team_roster(team_id=42, which='current')
standings = api.get_standings(season=12, division_abbrev='ALE')
transactions = api.get_transactions(season=12, team_abbrev='CAR')
batting = api.get_season_batting_stats(season=12, min_pa=100, sort_by='woba', limit=50)
pitching = api.get_season_pitching_stats(season=12, min_outs=150, sort_by='era', limit=50)
```

**OpenAPI docs**: `http://10.10.0.42/api/docs`
**Router source**: `/mnt/NV2/Development/major-domo/database/app/routers_v3/`