> For the complete documentation index, see [llms.txt](https://docs.sportradar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportradar.com/uof/custombet-cb/common-responses-and-errors.md).

# 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                                                                                                                               |                                                            |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sportradar.com/uof/custombet-cb/common-responses-and-errors.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.