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.
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"}'{
"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.
successis true when a target code exists.partialis true when at least one game did not map.verifiedis true when the target code loads with games.billing.credits_usedis the total used in the current API credit period.billing.priceis 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.
- Read authentication before you ship.
- Read convert for batch calls.
- Read limits for plan limits.
- Use the Python SDK or the TypeScript SDK to add retries and idempotency.