# Common Responses and Errors

This page lists all common responses and errors shared across all **four** endpoints.

#### Response codes <a href="#commonresponsesanderrors-responsecodes" id="commonresponsesanderrors-responsecodes"></a>

|     |                       |                                                                                                                                                                                                                        |
| --- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200 | Ok                    | When everything is ok and we return data directly in the http body.                                                                                                                                                    |
| 400 | Bad request           | <p>Possible reasons:</p><ul><li>Contradiction in selected markets</li><li>Selecting an unavailable market</li><li>Creating a combination on markets that is not allowed</li><li>Malformed request body, etc.</li></ul> |
| 401 | Unauthorized          | Token is missing or invalid                                                                                                                                                                                            |
| 403 | Forbidden             | Access to Custom Bet not allowed                                                                                                                                                                                       |
| 429 | Too many requests     | Rate limit was reached                                                                                                                                                                                                 |
| 500 | Internal server error | Unexpected error. Feel free to contact our support if you see this error.                                                                                                                                              |
| 503 | Service unavailable   | Returned when the underlying odds producers are temporarily down. Retry again soon.                                                                                                                                    |

<br>

#### Common 4xx Errors  <a href="#commonresponsesanderrors-common4xxerrors" id="commonresponsesanderrors-common4xxerrors"></a>

| Response Code                                                                                           | Condition                                                                                                                                                        | Response message from Custom Bet API                       |
| ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| Response Code                                                                                           | Condition                                                                                                                                                        | Response message from Custom Bet API                       |
| 400                                                                                                     | Contradiction                                                                                                                                                    | This combination is not possible, contradictory selections |
| Bad Bookmaker                                                                                           | Bookmaker is not configured                                                                                                                                      |                                                            |
| Bad Condition                                                                                           | The market cannot be created for (Id)                                                                                                                            |                                                            |
| Bad Market                                                                                              | The market is unavailable: (MarketId)                                                                                                                            |                                                            |
| Bad Outcome                                                                                             | The outcome (OutcomeID) is not found                                                                                                                             |                                                            |
| Bookmaker package access error                                                                          | Bookmaker (bookmakerId) has no access to the Sport (sportId)                                                                                                     |                                                            |
| Illegal argument                                                                                        | Illegal arguments combination                                                                                                                                    |                                                            |
| Illegal market combination                                                                              | Illegal market combination                                                                                                                                       |                                                            |
| Illegal Player combination                                                                              | Illegal player combination, you cannot combine same players                                                                                                      |                                                            |
| Illegal selection more than one player market line                                                      | Illegal selection, more than one outcome per market line per player!                                                                                             |                                                            |
| Illegal selection player markets                                                                        | Illegal selection, between player markets                                                                                                                        |                                                            |
| Implied market combination                                                                              | <p>One or more market selections imply a similar outcome to another market selection.<br>Please select different markets</p>                                     |                                                            |
| Invalid event state                                                                                     | No state for the event: (match id)                                                                                                                               |                                                            |
| Invalid market outcome combination                                                                      | Illegal/Implied market and outcome combinations                                                                                                                  |                                                            |
| Invalid matrix event                                                                                    | No matrix data for the event: (match id)                                                                                                                         |                                                            |
| Limit match combination exceeded                                                                        | Match combination exceed the limit                                                                                                                               |                                                            |
| Malformed body                                                                                          | Request body missing or malformed                                                                                                                                |                                                            |
| Missing specifier                                                                                       | Required specifier is missing: (SpecifierId)                                                                                                                     |                                                            |
| No Specifier                                                                                            | No specifiers when specifiers are required                                                                                                                       |                                                            |
| Number of selections exceeded limit                                                                     | Number of selections cannot be more than (selectionLimit)                                                                                                        |                                                            |
| Player Not found (In Multiple anytime goal scorer)                                                      | No probabilities for some players:(Player id)                                                                                                                    |                                                            |
| Player probability is higher in Multiple anytime goal scorer                                            | <p>The selected players of a team have a combined scoring-likelihood of more than 100%.<br>This is because a very likely benchplayer was added to the ticket</p> |                                                            |
| Probability of the combined selections is too low                                                       | Negligible Probability. The combination selected is too unlikely to happen, please select a different combination.                                               |                                                            |
| Selection implies another market outcome                                                                | One or more market selections imply a similar outcome to another market selection. Please select different markets.                                              |                                                            |
| Unknown Specifier                                                                                       | Specifier not recognized: (SpecifierId)                                                                                                                          |                                                            |
| Unavailable market selection                                                                            | Selected market is unavailable: (MarketID), specifier: (SpecifierNameAndValue)                                                                                   |                                                            |
| Unsupported specifier value                                                                             | Unsupported or bad specifier value                                                                                                                               |                                                            |
| Wrong Number of specifiers                                                                              | Expected (Specifier count) specifier(s) but was (Given specifier count)                                                                                          |                                                            |
| For non-total markets, when the market ID is not unique                                                 | This combination is not possible, contradictory selections. Duplicate market ID XXX found for match ID XXX.                                                      |                                                            |
| For total markets, when the same market ID has non-unique outcome IDs.                                  | One or more market selections imply a similar outcome to another market selection. Duplicate outcome ID %d in market ID %d. Please select only one."             |                                                            |
| <p>For total markets, when the same market ID has over total greater than others down the list.<br></p> | This combination is not possible, contradictory selections. Under total %f should be greater than over total %f in combination with market ID %d.                |                                                            |
| <p>For total markets, when the same market ID has totals that are too close in values.<br></p>          | This combination is not possible, contradictory selections. Not sufficient difference between over total %f and under total %f in market ID %d.                  |                                                            |
| 404                                                                                                     | Invalid event                                                                                                                                                    | No data for the event: (match id)                          |
| 409                                                                                                     | API Unavailable                                                                                                                                                  | Custom Bet API currently unavailable for prematch data     |
| Betting not available yet                                                                               | Betting has not started                                                                                                                                          |                                                            |
| <p>BetStop event occurred and betting is not allowed<br></p>                                            | Betstop status (bettingReason)                                                                                                                                   |                                                            |
| <p>Limit match combination exceeded<br></p>                                                             | Match combination exceed the limit                                                                                                                               |                                                            |
