Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Endpoint

Request Cashout for Bet Builder Ticket

post

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.

Authorizations
x-access-tokenstringRequired
Header parameters
x-bookmakerstringOptional

Bookmaker identifier. Required for direct custombet-api integration; typically injected by the gateway for public UOF integrators.

Example: 12345
x-bookmaker-packagesstringOptional

Bookmaker package entitlements required for calculation/pricing.

Example: custombet
x-sport-idstringOptional

Optional sport URN when match URNs on individual selections are sufficient.

Example: sr:sport:1
Body
event_idstringOptional

Optional 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.

Example: sr:match:75264004
Responses
200

Cashout 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.

cash_out_statusstring · enumRequired

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.

Example: AVAILABLEPossible values:
fair_probabilitynumber · floatOptional

Fair probability of the eligible selections. Present only when cash_out_status is AVAILABLE.

Example: 0.41417634
fair_oddsnumber · floatOptional

Fair decimal odds of the eligible selections. Present only when cash_out_status is AVAILABLE.

Example: 2.15703076
messagestringOptional

Optional human-readable detail regarding the rejection reason (especially for UNAVAILABLE and CLOSED).

Example: At least one market selection is currently not eligible for cashout.
post/v2/custombet/cashout
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?