---
# nuzlocke-tracker-bkhs
title: API Endpoints Implementation
status: todo
type: task
priority: normal
created_at: 2026-02-04T15:46:59Z
updated_at: 2026-02-04T15:47:23Z
parent: nuzlocke-tracker-f5ob
blocking:
    - nuzlocke-tracker-8fcj
    - nuzlocke-tracker-hy41
---

Implement the REST/GraphQL API endpoints for the tracker.

## Checklist
- [ ] Reference Data endpoints (read-only for tracker):
  - [ ] GET /api/games - List all games
  - [ ] GET /api/games/:id - Get game details with routes
  - [ ] GET /api/games/:id/routes - List routes for a game
  - [ ] GET /api/routes/:id/pokemon - List available Pokémon for a route
  - [ ] GET /api/pokemon/:id - Get Pokémon details
- [ ] Run Management endpoints:
  - [ ] POST /api/runs - Create new run
  - [ ] GET /api/runs - List all runs
  - [ ] GET /api/runs/:id - Get run details with encounters
  - [ ] PATCH /api/runs/:id - Update run (settings, status)
  - [ ] DELETE /api/runs/:id - Delete a run
- [ ] Encounter endpoints:
  - [ ] POST /api/runs/:id/encounters - Log new encounter
  - [ ] PATCH /api/encounters/:id - Update encounter (status, nickname)
  - [ ] DELETE /api/encounters/:id - Remove encounter
- [ ] Add request validation
- [ ] Add proper error responses

## Notes
- Follow REST conventions
- Return appropriate HTTP status codes
- Include pagination for list endpoints if needed