Endpoint
Evaluates ticket selections for cashout eligibility. Returns cashout availability, fair probability, and fair odds (HTTP 200 AVAILABLE). If selections are ineligible or fully settled, rejection details are returned with HTTP 400 (UNAVAILABLE or CLOSED). Public gateway may expose this at /v1custombet/cashout.
Bookmaker identifier. Required for direct custombet-api integration; typically injected by the gateway for public UOF integrators.
12345Bookmaker package entitlements required for calculation/pricing.
custombetOptional sport URN when match URNs on individual selections are sufficient.
sr:sport:1Optional match URN (e.g. sr:match:75264004). When provided, Probabilities API line lookup is executed prior to pricing. Omit for multi-match tickets or when skipping PAPI line gating.
sr:match:75264004Cashout priced successfully. cash_out_status is AVAILABLE with fair_probability and fair_odds. Closed/settled markets may appear under closed_selection and are excluded from pricing.
Ticket cashout status. AVAILABLE (HTTP 200) indicates cashout is priced. UNAVAILABLE (HTTP 400) indicates at least one leg is ineligible. CLOSED (HTTP 400) indicates all legs are settled.
AVAILABLEPossible values: Fair probability of the eligible selections. Present only when cash_out_status is AVAILABLE.
0.41417634Fair decimal odds of the eligible selections. Present only when cash_out_status is AVAILABLE.
2.15703076Optional human-readable detail regarding the rejection reason (especially for UNAVAILABLE and CLOSED).
At least one market selection is currently not eligible for cashout.Cashout rejection or malformed payload. When rejected by business rules, returns the CashOutResponse shape with cash_out_status UNAVAILABLE (ineligible markets) or CLOSED (all legs settled).
Unauthorized. x-access-token is missing or invalid.
Forbidden. Cashout feature flag is disabled for the bookmaker or sport.
No data found for the event or selections.
Conflict or service temporarily unavailable (e.g. calculation rules blocked or match disabled).
Too many requests. Rate limit reached.
Internal Server Error. Retry request or contact Sportradar support.
POST /v2/custombet/cashout HTTP/1.1
Host: api.betradar.com
x-access-token: YOUR_API_KEY
Content-Type: application/xml
Accept: */*
Content-Length: 398
"<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<cashOutRequest xmlns="http://schemas.sportradar.com/custombet/v1/endpoints" event_id="sr:match:75264004">
<selection id="sr:match:75264004" market_id="207" specifiers="setnr=1" outcome_id="866"/>
<selection id="sr:match:75264004" market_id="189" specifiers="total=26.5" outcome_id="13"/>
</cashOutRequest>"<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<cash_out_response xmlns="http://schemas.sportradar.com/custombet/v1/endpoints" cash_out_status="AVAILABLE" fair_probability="0.414176340081564333" fair_odds="2.1570307562997315">
<cashout_selection market_id="186" outcome_id="4" specifiers=""/>
<cashout_selection market_id="189" outcome_id="12" specifiers="total=17.5"/>
</cash_out_response>Last updated
Was this helpful?