Base URL:
All endpoints except fn=info require a Bearer token sent in the HTTP Authorization header. Your token is visible in My Account → API Token.
Returns API metadata and available endpoints. No authentication required.
No parameters required.
Returns picks from a Production app for a given day (and optionally previous days). This is the main consumption endpoint for mobile/web apps.
| Param | Required | Default | Description |
|---|---|---|---|
app_code | ✓ | — | Your Production app code, e.g. AB3X7K_P01 |
sport | all | Sport ID filter: 1=Football, 2=Tennis, 3=Basketball, etc. Omit for all sports. | |
day | today | Target date in YYYY-MM-DD format. Defaults to today in your account timezone. | |
history | 0 | Number of past days to include in addition to day. Maximum 7. |
id | Primary key of the pick row. |
ref_match_id | Match ID from the global pool. May be null for manually added picks. |
match_date | Raw date stored in the database. Use match_datetime when precision matters across timezone boundaries. |
match_time | Match start time as HH:mm in your account timezone. |
match_datetime | Full match start as YYYY-MM-DD HH:mm in your account timezone. Use this for display and grouping. |
score / win | ? until the result is entered. win values: 1=won, 0=lost, 2=unknown, ?=pending. |
timezone | The IANA timezone applied to all time fields — taken from your account settings. |
Returns the user's league list with their personal settings (isFavorite, isExpanded, star).
| Param | Required | Default | Description |
|---|---|---|---|
sport | all | Sport ID filter. Omit for all sports. | |
order | fav | Sort order: fav = favorites first, then stars; stars = by star rating; asc = alphabetical. |
league_id | Global league ID — matches ref_match_id league context in picks. |
isFavorite | 1 if the user has marked this league as a favorite. |
isExpanded | 1 if the league is expanded in the user's view. |
star | Star rating string (e.g. "5", "3"). Empty string if not rated. |
country_name | May be null for non-football sports. |
Returns the global match pool for a given date range, filtered by the user's league settings.
Params (reserved): start, end (YYYY-MM-DD), sport, timezone
| Code | Meaning |
|---|---|
400 | Bad request — missing or invalid parameter |
401 | Unauthorized — missing, invalid, or inactive Bearer token |
403 | Forbidden — tier restriction, wrong app type, or inactive app |
429 | Rate limit exceeded — maximum 100 requests per minute per account. Check the Retry-After response header for seconds remaining. |
All error responses include "success": false and a human-readable "message" field.