Account Promos

See the promos your accounts hold right now - Mega Boosts, odds boosts, savers, bonus bets, SGM savers - and place the ones that are a single bet with one call, by id.

Base URL: https://api.b337.ai

This is the same list the Manual Betting page shows, with the same wording. Everything here can also be placed from the Manual Betting page.

---

What is an account promo?

When a session logs in, it reads the offers the bookie is showing that account and stores them. Each one becomes an account promo with a stable promo_id. Most promos are tokens you spend on a selection you choose (a saver on any runner in a race, a bonus bet on any market). A few are a whole bet the bookie has already built and priced - a bet365 Mega Boost ("Horse A or Horse B (Either to Win) 1.50 → 2.00") is one. Those have exactly one possible bet, so you can place them by id alone.

---

1. List promos - GET /v3/account_promos {#list}

Synchronous read. Only active promos are returned; no bookie is contacted.

Query parameters

curl "https://api.b337.ai/v3/account_promos?session_id=900" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "success": true,
  "count": 2,
  "promos": [
    {
      "promo_id": 363983,
      "session_id": "900",
      "session_ids": ["900"],
      "account_id": "uuid",
      "bookie": "bet365",
      "promo": "bet_boost",
      "label": "Mega Boost",
      "summary": {
        "label": "Mega Boost",
        "headline": "Rosehill R8 (R)",
        "detail": "Horse A or Horse B (Either to Win) · 1.50 -> 2.00"
      },
      "kind": "racing",
      "epk": "rosehill/8/(R)/au/2026-09-26",
      "track": "Rosehill",
      "race_num": 8,
      "race_type": "(R)",
      "date": "2026-09-26",
      "card_id": "3209180",
      "voucher_type": "pba",
      "selection": "Horse A or Horse B (Either to Win)",
      "base_odds": 1.5,
      "boosted_odds": 2.0,
      "placeable_by_id": true,
      "how_to_bet": { "endpoint": "/v3/place_promo" }
    },
    {
      "promo_id": 363990,
      "session_id": "900",
      "session_ids": ["900"],
      "account_id": "uuid",
      "bookie": "bet365",
      "promo": "2/3",
      "label": "2nd or 3rd",
      "summary": {
        "label": "2nd or 3rd",
        "headline": "Rosehill R7 (R)",
        "detail": "Run 2nd or 3rd, get your stake back"
      },
      "kind": "racing",
      "track": "Rosehill",
      "race_num": 7,
      "race_type": "(R)",
      "date": "2026-09-26",
      "placeable_by_id": false,
      "how_to_bet": {
        "endpoint": "/v3/place_bet",
        "promo_name": "2/3",
        "note": "This promo has more than one possible bet: choose the selection and place it with POST /v3/place_bet and promo_name."
      }
    }
  ]
}

Promo object

placeable_by_id

true only for a bet365 Bet Boost card (e.g. a Mega Boost) of a single fixture - a single racing selection, or a single sports game - whose boosted price has been captured. Multi / outright cards and cards with no captured price are false.

how_to_bet

---

2. Place a promo by id - POST /v3/place_promo {#place}

Places a promo whose placeable_by_id is true. Send no price, selection or market - the card already names them. At bet time the session re-reads the card from the bookie and refuses if it has gone or is no longer boosted.

Request

{
  "session_id": "900",
  "promo_id": 363983,
  "stake": 10,
  "idempotency_key": "mega-boost-rosehill-r8"
}

Response (202)

The same async envelope as /v3/place_bet, plus the promo_id:

{
  "status": "pending",
  "correlation_id": "9b3c…uuid…",
  "session_id": "900",
  "bookie": "bet365",
  "username": "user@example.com",
  "submitted_at": "2026-09-26T04:00:00.000Z",
  "timeout_at": "2026-09-26T04:05:00.000Z",
  "callback_url": null,
  "trace_id": null,
  "promo_id": 363983
}

Getting the result

Poll POST /api/bet_status with {"correlation_ids": ["…"]} every 1-2s until status is completed or timeout, or pass callback_url to receive a signed webhook. Details in the Async API (v3) guide. The bet is recorded as a promo bet (bet_type: "promo", promo_name: "bet_boost").

import requests, time

BASE_URL = "https://api.b337.ai"
HEADERS = {"X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json"}

promos = requests.get(f"{BASE_URL}/v3/account_promos",
                      headers=HEADERS, params={"bookie": "bet365"}).json()["promos"]
card = next(p for p in promos if p["placeable_by_id"] and p["session_id"])

sub = requests.post(f"{BASE_URL}/v3/place_promo", headers=HEADERS, json={
    "session_id": card["session_id"],
    "promo_id": card["promo_id"],
    "stake": 10,
    "idempotency_key": f"promo-{card['promo_id']}",
}).json()

while True:
    st = requests.post(f"{BASE_URL}/api/bet_status", headers=HEADERS,
                       json={"correlation_ids": [sub["correlation_id"]]}).json()
    entry = st["statuses"][0]
    if entry["status"] != "pending":
        print(entry)
        break
    time.sleep(2)

Errors

Promos with more than one choice (racing boosts, savers, bonus bets) are still placed via /v3/place_bet with promo_name. See Bonus Bets & Promos for the token flags.

---

Next Steps

• Place Bet (v3) - Spend a token on a selection you choose
• Bonus Bets & Promos - Bonus bet tokens and split options
• Async API (v3) guide - Polling and webhook semantics