> For the complete documentation index, see [llms.txt](https://peerplays.gitbook.io/peerplays-infrastructure-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://peerplays.gitbook.io/peerplays-infrastructure-docs/couch-potato/api/api-reference/error-codes.md).

# Error Codes

## **General Errors** <a href="#general-errors" id="general-errors"></a>

### **430  - Failed to delete league** <a href="#id-430" id="id-430"></a>

| **Sub Code** | Title                                   | Message                                           |
| ------------ | --------------------------------------- | ------------------------------------------------- |
| 430          | Failed to delete event league \[league] | League might not exist or parameters are missing. |

### **431  - Failed to delete game** <a href="#id-431" id="id-431"></a>

| **Sub Code** | Title                         | Message                                         |
| ------------ | ----------------------------- | ----------------------------------------------- |
| 431          | Failed to delete game \[game] | Game might not exist or parameters are missing. |

### 432 - Failed to get all games by date range <a href="#id-432" id="id-432"></a>

| **Sub Code** | Title                                                                | Message                                      |
| ------------ | -------------------------------------------------------------------- | -------------------------------------------- |
| 432          | Failed to get all games in the date range \[startdate] to \[enddate] | Invalid date range or parameters are missing |

### 433 - Failed to get all games <a href="#id-433" id="id-433"></a>

| **Sub Code** | Title                   | Message |
| ------------ | ----------------------- | ------- |
| 433          | Failed to get all games | None    |

### 434 - Failed to get all sports <a href="#id-434" id="id-434"></a>

| **Sub Code** | Title                    | Message |
| ------------ | ------------------------ | ------- |
| 434          | Failed to get all sports | None    |

### 435 - Failed to get all games by league and date range <a href="#id-435" id="id-435"></a>

| **Sub Code** | Title                                                                  | Message                                      |
| ------------ | ---------------------------------------------------------------------- | -------------------------------------------- |
| 435          | Failed to get all games in league \[league] between \[start] to \[end] | Invalid date range or parameters are missing |

### 436 - Failed to get all games by league <a href="#id-436" id="id-436"></a>

| **Sub Code** | Title                                       | Message |
| ------------ | ------------------------------------------- | ------- |
| 436          | Failed to get all games in league \[league] | None    |

### 437 - Failed to get all leagues by sport <a href="#id-437" id="id-437"></a>

| **Sub Code** | Title                                         | Message |
| ------------ | --------------------------------------------- | ------- |
| 437          | Failed to get all leagues for sport \[sport ] | None    |

### 438 - Failed to get all sports and leagues <a href="#id-438" id="id-438"></a>

| **Sub Code** | Title                                | Message |
| ------------ | ------------------------------------ | ------- |
| 438          | Failed to get all sports and leagues | None    |

### 439 - Failed to get teams for league <a href="#id-439" id="id-439"></a>

| **Sub Code** | Title                                         | Message |
| ------------ | --------------------------------------------- | ------- |
| 439          | Failed to get all teams for league \[ league] | None    |

### 440 - Failed to get last event id by date and league <a href="#id-440" id="id-440"></a>

| **Sub Code** | Title                                                           | Message |
| ------------ | --------------------------------------------------------------- | ------- |
| 440          | Failed to get the last event id for league \[league] on \[date] |         |

### 441 - Failed to get last event id <a href="#id-441" id="id-441"></a>

| **Sub Code** | Title                           | Message |
| ------------ | ------------------------------- | ------- |
| 441          | Failed to get the last event id |         |

### 442 - Failed to get last game id by date and league  <a href="#id-442" id="id-442"></a>

| **Sub Code** | Title                                                          | Message |
| ------------ | -------------------------------------------------------------- | ------- |
| 442          | Failed to get the last game id for league \[league] on \[date] |         |

### 443 - Failed to get last game id <a href="#id-443" id="id-443"></a>

| **Sub Code** | Title                                         | Message |
| ------------ | --------------------------------------------- | ------- |
| 443          | Failed to get the last game id for all sports |         |

### 444 - Failed to get last game <a href="#id-444" id="id-444"></a>

| **Sub Code** | Title                                      | Message |
| ------------ | ------------------------------------------ | ------- |
| 444          | Failed to get the last game for all sports |         |

### 445 - Failed to run replay <a href="#id-445" id="id-445"></a>

| **Sub Code** | Title                             | Message                                        |
| ------------ | --------------------------------- | ---------------------------------------------- |
| 445          | Failed to run replay for \[sport] | Replay failed to send to one or more endpoints |

### 446 - Failed to get league details <a href="#id-446" id="id-446"></a>

| **Sub Code** | Title                                          | Message |
| ------------ | ---------------------------------------------- | ------- |
| 446          | Failed to get league details for \[leaguename] |         |

### 447 - Failed to change password

| **Sub Code** | Title                                     | Message |
| ------------ | ----------------------------------------- | ------- |
| 447          | Failed to change password for \[username] |         |

### 448 - Failed to get user active state

| **Sub Code** | Title                                          | Message |
| ------------ | ---------------------------------------------- | ------- |
| 448          | Failed to get active state for user \[userid ] |         |

## **BOS Errors** <a href="#bos-errors" id="bos-errors"></a>

### **450 - Not normalized incident**

**Incident message contained either an invalid sport or league (event group).**

| **Sub Code** | Title                   | Message                                                                                    |
| ------------ | ----------------------- | ------------------------------------------------------------------------------------------ |
| 450          | Not normalized incident | Object of type [BOS Schema](/peerplays-infrastructure-docs/couch-potato/api/bos-schema.md) |

### **451- Invalid data format**

**Incident message was incorrectly formed.**

| **Sub Code** | Title               | Message                                                                                    |
| ------------ | ------------------- | ------------------------------------------------------------------------------------------ |
| 451          | Invalid data format | Object of type [BOS Schema](/peerplays-infrastructure-docs/couch-potato/api/bos-schema.md) |

### **452- Internal server error**

**BOS node for selected endpoint might not be available**

| **Sub Code** | Title                 | Message |
| ------------ | --------------------- | ------- |
| 452          | Internal server error |         |

## **Incident Errors** <a href="#incident-errors" id="incident-errors"></a>

### **460 - Invalid sport**

| **Sub Code** | Title                  | Message                             |
| ------------ | ---------------------- | ----------------------------------- |
| 460          | Invalid sport \[sport] | Try one of: \[list of valid sports] |

### **461 - Invalid league**

| **Sub Code** | Title                    | Message                              |
| ------------ | ------------------------ | ------------------------------------ |
| 461          | Invalid league \[league] | Try one of: \[list of valid leagues] |

### **462 - Invalid home team**

| **Sub Code** | Title                     | Message                            |
| ------------ | ------------------------- | ---------------------------------- |
| 462          | Invalid home team \[team] | Try one of: \[list of valid teams] |

### **463 - Invalid away team**

| **Sub Code** | Title                     | Message                            |
| ------------ | ------------------------- | ---------------------------------- |
| 463          | Invalid away team \[team] | Try one of: \[list of valid teams] |

### **464 - Invalid start time**

| **Sub Code** | Title              | Message                              |
| ------------ | ------------------ | ------------------------------------ |
| 464          | Invalid start time | Format is \[YYYY-MM-DDTHH:MM:SS.00Z] |

### **465 - Duplicate teams**

| **Sub Code** | Title                                     | Message                 |
| ------------ | ----------------------------------------- | ----------------------- |
| 465          | Invalid teams selection \[home] v \[away] | Teams must be different |

### **466 - Invalid user**

| **Sub Code** | Title                   | Message                 |
| ------------ | ----------------------- | ----------------------- |
| 466          | Invalid user id \[user] | The user id was invalid |

## **Add Game Errors** <a href="#add-game-errors" id="add-game-errors"></a>

### **470 - Add new game parameter error(s)**

| **Sub Code** | Title                                    | Message                                                      |
| ------------ | ---------------------------------------- | ------------------------------------------------------------ |
| 470          | Missing parameters \[list of parameters] | Parameters are: sport, league, home, away, start\_time, user |

### **471 - Failed to get last event id**

| **Sub Code** | Title                       | Message |
| ------------ | --------------------------- | ------- |
| 471          | Failed to get last event id | None    |

### **472 - Failed to add new event**

| **Sub Code** | Title                   | Message |
| ------------ | ----------------------- | ------- |
| 472          | Failed to add new event | None    |

### **473 - Failed to get new event id**

| **Sub Code** | Title                      | Message |
| ------------ | -------------------------- | ------- |
| 473          | Failed to get new event id | None    |

### **474 - Failed to add new game**

| **Sub Code** | Title                  | Message |
| ------------ | ---------------------- | ------- |
| 474          | Failed to add new game | None    |

### **475 - Failed to get new game id**

| **Sub Code** | Title                     | Message |
| ------------ | ------------------------- | ------- |
| 475          | Failed to get new game id | None    |

### **476 - Failed to update game progress**

| **Sub Code** | Title                          | Message |
| ------------ | ------------------------------ | ------- |
| 476          | Failed to update game progress | None    |

### **477 - Failed to add new game progress**

| **Sub Code** | Title                           | Message |
| ------------ | ------------------------------- | ------- |
| 477          | Failed to add new game progress | None    |

### **478 - Game already exists**

| **Sub Code** | Title               | Message                                |
| ------------ | ------------------- | -------------------------------------- |
| 478          | Game already exists | A game can't be created more than once |

## **Start Game Errors** <a href="#start-game-errors" id="start-game-errors"></a>

### **480 - Start game parameter error(s)**

| **Sub Code** | Title                                    | Message                                                                                 |
| ------------ | ---------------------------------------- | --------------------------------------------------------------------------------------- |
| 480          | Missing parameters \[list of parameters] | Parameters are: sport, league, home, away, start\_time, whistle\_start\_time, match\_id |

### **481 - Whistle start time is before start time**

| **Sub Code** | Title                                                                              | Message                                                          |
| ------------ | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| 481          | Whistle start time \[whistle\_start\_time] is before the start time \[start\_time] | The whistle start time must be equal to or after the start time. |

### **482 - Failed to add whistle start time**

| **Sub Code** | Title                            | Message |
| ------------ | -------------------------------- | ------- |
| 482          | Failed to add whistle start time | None    |

### **483 - Failed to update game progress**

| **Sub Code** | Title                          | Message |
| ------------ | ------------------------------ | ------- |
| 483          | Failed to update game progress | None    |

### **484 - Game must not have already started**

| **Sub Code** | Title                              | Message |
| ------------ | ---------------------------------- | ------- |
| 484          | Game must not have already started | None    |

## **Add Scores Errors** <a href="#add-score-errors" id="add-score-errors"></a>

### **485 - Add score parameter error(s)**

| **Sub Code** | Title                                    | Message                                                                                     |
| ------------ | ---------------------------------------- | ------------------------------------------------------------------------------------------- |
| 48**5**      | Missing parameters \[list of parameters] | Parameters are: sport, league, home, away, start\_time, home\_score, away\_score, match\_id |

### **486 - Game must be in progress**

| **Sub Code** | Title                              | Message |
| ------------ | ---------------------------------- | ------- |
| 486          | Game must not have already started | None    |

### **487 - Failed to add scores**

| **Sub Code** | Title                              | Message |
| ------------ | ---------------------------------- | ------- |
| 487          | Game must not have already started | None    |

## **Finish Game Errors** <a href="#finish-game-errors" id="finish-game-errors"></a>

### **490 - Finish parameter error(s)**

| **Sub Code** | Title                                    | Message                                                                               |
| ------------ | ---------------------------------------- | ------------------------------------------------------------------------------------- |
| 4**90**      | Missing parameters \[list of parameters] | Parameters are: sport, league, home, away, start\_time, whistle\_end\_time, match\_id |

### **491 - Whistle end time is before whistle start time**

| **Sub Code** | Title                                                                                           | Message                                                                |
| ------------ | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| 491          | Whistle end time \[whistle\_end\_time] is before the whistle start time \[whistle\_start\_time] | The whistle end time must be equal to or after the whistle start time. |

### **492 - Failed to add whistle end time**

| **Sub Code** | Title                          | Message |
| ------------ | ------------------------------ | ------- |
| 492          | Failed to add whistle end time | None    |

### **493 - Failed to update game progress**

| **Sub Code** | Title                          | Message |
| ------------ | ------------------------------ | ------- |
| 493          | Failed to update game progress | None    |

### **494 - Game must have a score**

| **Sub Code** | Title                          | Message                                             |
| ------------ | ------------------------------ | --------------------------------------------------- |
| 494          | Failed to update game progress | A game can't be finished until the scores are added |

## **Cancel Game Errors** <a href="#cancel-game-errors" id="cancel-game-errors"></a>

### **495 - Canceled parameter error(s)**

| **Sub Code** | Title                                    | Message                                                                               |
| ------------ | ---------------------------------------- | ------------------------------------------------------------------------------------- |
| 49**5**      | Missing parameters \[list of parameters] | Parameters are: sport, league, home, away, start\_time, whistle\_end\_time, match\_id |

### **496 - Failed to update game progress**

| **Sub Code** | Title                          | Message         |
| ------------ | ------------------------------ | --------------- |
| 496          | Failed to update game progress | <p>None<br></p> |

### **497 - Game can't be canceled**

| **Sub Code** | Title                  | Message                                                                        |
| ------------ | ---------------------- | ------------------------------------------------------------------------------ |
| 496          | Game can't be canceled | A game can only be canceled if it hasn't started, or if it's still in progress |

## Server Errors <a href="#server-errors" id="server-errors"></a>

### 540 - Unable to log in

| **Sub Code** | Title            | Message                                                            |
| ------------ | ---------------- | ------------------------------------------------------------------ |
| 540          | Unable to log in | Could happen due to gateway time out errors or web service failure |