Reference
Glossary
Values the endpoint pages refer to: sport ids, error codes, countries, the pager and event status.
R-SportID
Pass the id as sport_id. Ids follow bet365's numbering and never change.
| sport_id | Sport |
|---|---|
| 1 | Soccer |
| 2 | Horse Racing |
| 3 | Cricket |
| 4 | Greyhounds |
| 8 | Rugby Union |
| 9 | Boxing |
| 12 | American Football |
| 13 | Tennis |
| 14 | Snooker |
| 15 | Darts |
| 16 | Baseball |
| 17 | Ice Hockey |
| 18 | Basketball |
| 19 | Rugby League |
| 36 | Australian Rules |
| 66 | Bowls |
| 75 | Gaelic Sports |
| 78 | Handball |
| 83 | Futsal |
| 90 | Floorball |
| 91 | Volleyball |
| 92 | Table Tennis |
| 94 | Badminton |
| 95 | Beach Volleyball |
| 107 | Squash |
| 110 | Water Polo |
| 151 | E-sports |
| 162 | MMA/UFC |
- Esoccer is listed under Soccer (
1) and Ebasketball under Basketball (18). See Esports. - Horse Racing (
2) and Greyhounds (4) are only available raw, in the Bet365 API.
R-Errors
A failed call returns success: 0 and one of these codes in error. See Errors.
| error | Meaning |
|---|---|
| INTERNAL_SERVER_ERROR | 500 Internal Server Error. Contact support if it keeps happening. |
| NOT_FOUND | 404 Not Found. |
| METHOD_NOT_ALLOWED | Method is not allowed, only GET is supported. |
| UNDER_MAINTENANCE | API is under maintenance. We announce it in advance. |
| AUTHORIZE_FAILED | Token is not provided or is incorrect. |
| TOO_MANY_REQUESTS | API rate limit exceeded. See X-RateLimit-Reset. |
| PERMISSION_DENIED | Your plan does not include this call. Contact support if this is wrong. |
| PARAM_REQUIRED | A required param is missing. Check error_detail. |
| PARAM_INVALID | A param is invalid. Check error_detail. |
R-Countries
cc is a lowercase ISO 3166-1 alpha-2 country code. Use it to filter Upcoming Events, Ended Events, League and Team, for example cc=co for Colombia. Common codes:
| cc | Country |
|---|---|
| gb | United Kingdom (England, Scotland, Wales, Northern Ireland) |
| ie | Ireland |
| es | Spain |
| it | Italy |
| de | Germany |
| fr | France |
| pt | Portugal |
| nl | Netherlands |
| br | Brazil |
| ar | Argentina |
| co | Colombia |
| us | United States |
| jp | Japan |
| au | Australia |
R-Pager
Paginated calls take page and return pager with page, per_page and total. The maximum page is 100; to go further back on ended events, use day.
{
"success": 1,
"pager": { "page": 2, "per_page": 50, "total": 312 },
"results": [ ... ]
}Endpoints with a pager:
- Upcoming Events
/v3/events/upcoming - Ended Events
/v3/events/ended - Merge History
/v1/event/merge_history - Bet365 Upcoming Events
/v1/bet365/upcoming
League and Team return data by id, highest first, with pager.min_id. Call without max_id, then pass min_id as max_id until results is empty.
{
"success": 1,
"pager": { "min_id": "10041237" },
"results": [ ... ]
}time_status
Every event carries time_status. Most events go from 0 to 1 to 3. A final status does not change again, so you can stop polling the event.
| Code | Status | When it happens | Final |
|---|---|---|---|
| 0 | Not started | Listed and not started. Pre-match odds are available. | No |
| 1 | In play | Started. Score, timer, stats and in-play odds update live. | No |
| 2 | To be fixed | Listed, but the start time is not confirmed. time can change. | No |
| 3 | Ended | Finished. Final score and stats are available. | Yes |
| 4 | Postponed | Will not be played at the listed time. | Yes |
| 5 | Cancelled | Cancelled and will not be played. | Yes |
| 6 | Walkover | One side advanced without playing, common in tennis. | Yes |
| 7 | Interrupted | Play stopped, for example for rain. It can resume and return to 1. | No |
| 8 | Abandoned | Play stopped and was not resumed. | Yes |
| 9 | Retired | A player retired during the match, as in tennis or darts. | Yes |
| 10 | Suspended | The organiser suspended the event. It can resume or move to another status. | No |
| 11 | Decided by FA | The result was decided by the governing body. | Yes |
| 12 | Disqualified | A player or team was disqualified. | Yes |
| 99 | Removed | Removed from the listings, usually a duplicate. See Merge History. | Yes |
2, 7 and 10 are temporary. Keep polling at a lower rate until the event moves to another status.
Common fields
| Field | Meaning |
|---|---|
| id | Our id in the Events API. In the Bet365 API lists, the bet365 fixture id (FI). |
| bet365_id | bet365 fixture id of an Events API event. Pass it as FI to the Bet365 API. |
| our_event_id | Events API id of a Bet365 API event. |
| time | Start time, UTC epoch in seconds. |
| ss | Short score, e.g. "2-1". null before the start. |
| scores | Score by period. For soccer, "1" is the first half and "2" the full time. |
| timer | tm minutes, ts seconds, tt "1" while the clock runs, ta added time, md period. |
| cc | Country, see R-Countries. null for international leagues and esports. |
| image_id | Team image id, or null. |
| is_esports | 1 for Esoccer, Ebasketball and other video game teams. |