Resolve picks
On this page
How to resolve picks into a 10-minute booking plan
The Manage Bet Codes API provides POST /v1/resolve to turn 1 to 50 picks into a short-lived booking plan tied to the API key. Resolve costs 0 API credits, returns a plan_id valid for 10 minutes, and reports each pick as resolved, ambiguous, not_found, market_missing, odds_changed, or not_bookable.
POST /v1/resolve
{
"bookmaker": "sportybet",
"picks": [
{"home_team": "Arsenal", "away_team": "Chelsea",
"league": "Premier League", "kickoff": "2026-11-03T20:00:00Z",
"market": "Over/Under", "outcome": "Over", "line": "2.5",
"odds": "1.90"}
],
"strict": true,
"accept_odds_change": false,
"detail": "agent"
}{
"plan_id": "plan_...",
"expires_at": "2026-11-03T20:10:00Z",
"status": "ready",
"bookmaker": {"key": "sportybet", "name": "SportyBet"},
"picks": [
{"index": 0, "status": "resolved",
"requested": "Arsenal vs Chelsea",
"event": {"id": "sr:match:123", "home": "Arsenal", "away": "Chelsea",
"league": "Premier League", "kickoff": "..."},
"market": {"id": "18", "canonical": "Over/Under", "line": "2.5"},
"outcome": {"id": "12", "canonical": "Over", "odds": "1.90"},
"confidence": "exact",
"bookable": true,
"next_action": "book"}
],
"summary": {"resolved": 1, "ambiguous": 0, "failed": 0},
"billing": {"action": "resolve", "price": 0}
}What each pick status means and what to do next
A Manage Bet Codes resolve reports each pick with a status and a next action: resolved picks are ready to book, ambiguous picks need one event_id chosen from candidates, and not_found, market_missing, odds_changed, or not_bookable picks must be skipped or changed before booking.
| Status | Meaning | Action |
|---|---|---|
resolved | One exact event and market. | Book. |
ambiguous | Several candidates, a loose match, or closest single-team fixtures when no head-to-head match exists. | Choose one event_id from candidates. |
not_found | No event matches either team. | Search or skip. |
market_missing | The event exists, but the market does not. | Skip or change the market. |
odds_changed | The price moved. | Accept or skip. |
not_bookable | The target cannot book this pick. | Skip. |
How long a booking plan lasts and which key owns it
A Manage Bet Codes booking plan holds 1 to 50 picks, costs 0 API credits to create, stays valid for 10 minutes, and belongs to the API key that created it. Use the plan_id with book before expiry: an expired plan returns 409 plan_expired and a plan outside the key returns 404 plan_not_found.
- Send 1 to 50 picks.
- Resolve costs 0 credits.
- The plan is valid for 10 minutes.
- The plan is tied to the key.
- Use the
plan_idwith book. - An expired plan returns
409 plan_expired. A plan outside the key returns404 plan_not_found.