Quickstart

On this page

How to create an API key on the dashboard

Create an API key from the API dashboard as a signed-in user with a verified email. The full key starts with mbc_live_, shows one time, and the server keeps no plaintext copy; name the key and set charge_order there. Verified Free accounts get 1 key and 5 lifetime action credits for testing.

The key starts with mbc_live_. Send it in the X-API-Key header on every call. Never put the key in browser code.

Convert one SportyBet code to 1xBet

Yes. Send POST https://api.managebetcodes.app/v1/convert with code 7B9A2F, from: sportybet, and to: 1xng, plus headers X-API-Key: mbc_live_... and a 24-hour Idempotency-Key. Manage Bet Codes returns the 1xBet code for 2 API credits, with success, partial, verified, counts, odds, and billing in the response, inside a 65-second per-target budget and an 80-second batch call.

Request
curl -X POST https://api.managebetcodes.app/v1/convert \
  -H "X-API-Key: mbc_live_your_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-call-001" \
  -d '{"code": "7B9A2F", "from": "sportybet", "to": "1xng"}'
Response 200
{
  "success": true,
  "source": {"key": "sportybet", "name": "SportyBet", "code": "7B9A2F"},
  "target": {"key": "onexbet", "name": "1xBet", "code": "R9QF0U"},
  "counts": {"original": 13, "converted": 12, "unmappable": 1},
  "odds": {"source": "24.51", "target": "23.90"},
  "partial": true,
  "verified": true,
  "fallbacks": [],
  "failures": [],
  "billing": {
    "action": "convert", "price": 2, "credits_used": 14,
    "credits_limit": 5000, "credits_reset": "2026-12-01T00:00:00Z"
  }
}

How to read the convert response and billing fields

A convert response returns success: true when a target code exists, partial: true when at least one game did not map, verified: true when the target code loads with games, and a billing block with the action price and current credit state. A failed call returns the error envelope with no target code.

  • success is true when a target code exists.
  • partial is true when at least one game did not map.
  • verified is true when the target code loads with games.
  • billing.credits_used is the total used in the current API credit period.
  • billing.price is the charge for this call. A convert costs 2 credits for each target.

A failed call returns the error envelope. It does not return a target code.

Where to go after your first call

After a successful first convert, read authentication before shipping, convert for batch calls, and limits for plan limits. Use the Python SDK or the TypeScript SDK to add retries and idempotency.

Related pages

AuthenticationBet Code Conversion APIErrorsLimits