v1.0.1 · Live · fpg-api-557f67b8bd-8m7b9
FPG API
RESTful API powering the Fantasy Premier Game app. All endpoints return JSON. Most require a Bearer token.
Quick start
Get the current round
# Get the current round number
curl https://fpg-api-557f67b8bd-8m7b9/round/current \
-H "Authorization: Bearer <your_token>"
curl https://fpg-api-557f67b8bd-8m7b9/round/current \
-H "Authorization: Bearer <your_token>"
Authenticate
# Exchange credentials for a JWT token
curl https://fpg-api-557f67b8bd-8m7b9/token \
-X POST \
-d "username=your@email.com&password=yourpassword" \
-H "Content-Type: application/x-www-form-urlencoded"
curl https://fpg-api-557f67b8bd-8m7b9/token \
-X POST \
-d "username=your@email.com&password=yourpassword" \
-H "Content-Type: application/x-www-form-urlencoded"
Endpoints
All routes
All endpoints except /, /api, /rules, and POST /token require a valid Bearer JWT. Tokens expire after 30 minutes.
Auth
POST/tokenExchange credentials for a JWT token
GET/users/me/Get the authenticated user's profile
POST/usersCreate a new user account
Rounds
GET/round/currentGet the current round number
GET/round/infoGet round metadata (type, deadline, modifiers)
GET/round/weeklyGet weekly summary data
GET/round/resultGet results for a round
Fixtures
GET/fixtureGet fixtures for a given round
Choices
GET/choiceGet all choices for a round
GET/choice/previousGet the authenticated player's previous picks
POST/choiceSubmit a pick for the current round
PUT/choiceChange an existing pick before the deadline
Points & Standings
GET/pointGet points breakdown for a round
GET/point/previousGet historical points
GET/standingGet the season standings table
GET/standing/rollingGet rolling standings
GET/season/overviewGet a player's full season overview
Players
GET/player/infoGet player stats (W/D/L counts)
PUT/player/usernameUpdate username
Notifications
POST/notificationRegister a push notification token
DELETE/notificationDeactivate push notifications
Interactive documentation
Explore and test every endpoint with the full Swagger UI.
Changelog
What's new
v1.0.1
Jun 2025
Jun 2025
Notification token registration added
Swagger UI integrated at /docs
Improved analytics logging via CALL_LOGS
v1.0.0
Jan 2025
Jan 2025
Initial release — full season 2024/25 support
JWT authentication with 30-minute token expiry
Standings, choices, fixtures, and scoring endpoints