API Reference

Complete REST API documentation for integrating the SportsBet Pro sportsbook platform. Place bets, manage sessions, fetch live odds, and embed widgets programmatically.

https://your-domain.com/api/provider

Authentication

API Key Authentication

All API requests must include your client_key parameter. For authenticated endpoints, pass the session token obtained from the provider session endpoint. Generate API keys from the Client Portal under Developer → API Keys.

Example// Include client key in every request
GET /api/provider/session?client=your_client_key&token=user_session_token

Base URL

All API endpoints are relative to your deployment domain. Replace your-domain.com with your actual server address.

Endpoints

POST /api/provider/place-bet

Place a new bet with one or more selections. Returns a booking confirmation with a unique booking code.

Request Body

Parameter	Type	Required	Description
client	string	Required	Your client key
token	string	Optional	Session token for authenticated users
currency	string	Required	Currency code (e.g., USD, EUR, TND)
stake	number	Required	Bet stake amount
total_odds	number	Required	Combined odds for all selections
selections	array	Required	Array of selection objects
selections[].event_id	integer	Required	Event identifier
selections[].market	string	Required	Market type (e.g., match_winner)
selections[].outcome	string	Required	Outcome key (e.g., home, draw, away)
selections[].odds	number	Required	Odds value for this selection

Example Request

JSON{
  "client": "your_client_key",
  "currency": "USD",
  "stake": 50.00,
  "total_odds": 2.45,
  "selections": [
    {
      "event_id": 142,
      "market": "match_winner",
      "outcome": "home",
      "odds": 2.45
    }
  ]
}

Example Response

200 OK{
  "success": true,
  "booking": {
    "booking_code": "BOOK-A1B2C3D4",
    "client": "your_client_key",
    "currency": "USD",
    "stake": 50.00,
    "total_odds": 2.45,
    "potential_win": 122.50,
    "selections": 1,
    "created_at": "2026-04-08T15:30:00Z"
  }
}

GET /api/provider/session

Validate a user session token and retrieve the user's balance and authentication status.

Query Parameters

Parameter	Type	Required	Description
client	string	Required	Your client key
token	string	Required	Session token to validate

Example Response (Authenticated)

200 OK{
  "authenticated": true,
  "user": {
    "id": "user_12345",
    "name": "John Doe"
  },
  "balance": 1250.00,
  "currency": "USD"
}

Example Response (Guest)

200 OK{
  "authenticated": false,
  "user": null,
  "balance": 0,
  "currency": "USD"
}

GET /api/provider/my-bets

Retrieve the bet history for a specific user. Returns recent bookings with status, stake, and payout.

Query Parameters

Parameter	Type	Required	Description
client	string	Required	Your client key
token	string	Required	User session token

Example Response

200 OK{
  "bets": [
    {
      "booking_code": "BOOK-A1B2C3D4",
      "stake": 50.00,
      "total_odds": 2.45,
      "potential_win": 122.50,
      "status": "booked",
      "selections": [ /* ... */ ],
      "placed_at": "2026-04-08T15:30:00Z"
    }
  ]
}

GET /widget/sportsbook/odds-feed

Retrieve the current odds feed with all sports, leagues, events, and markets. Used for live odds updates.

Query Parameters

Parameter	Type	Required	Description
client	string	Required	Your client key
sport	string	Optional	Filter by sport key (e.g., football)

Response Format

Returns an array of sports, each containing leagues and events with current odds values.

GET /widget/sportsbook

Embed the sportsbook widget as an iframe. The widget renders a complete betting interface themed to your brand.

Query Parameters

Parameter	Type	Required	Description
client	string	Required	Your client key
token	string	Optional	Session token for authenticated users
sport	string	Optional	Default sport (default: football)

Embed Code

HTML<!-- Embed sportsbook widget -->
<iframe
  src="https://your-domain.com/widget/sportsbook?client=YOUR_KEY"
  width="100%"
  height="800"
  frameborder="0"
  allow="clipboard-write"
></iframe>

Webhooks

Configure a webhook URL in your client settings to receive real-time event notifications. All webhook payloads are POST requests with JSON body.

Events

Event	Description
BOOKING_CREATED	Fired when a new bet is placed
BOOKING_SETTLED	Fired when a booking is settled (won/lost/void)

Webhook Payload

POST{
  "event": "BOOKING_CREATED",
  "timestamp": "2026-04-08T15:30:00Z",
  "data": {
    "booking_code": "BOOK-A1B2C3D4",
    "client_key": "your_client_key",
    "stake": 50.00,
    "status": "booked"
  }
}

Error Handling

All errors return a consistent JSON structure with an error message and appropriate HTTP status code.

Error Response{
  "success": false,
  "error": "Validation failed",
  "errors": {
    "stake": ["The stake field is required."]
  }
}

HTTP Status Codes

Code	Meaning
200	Success
400	Bad Request — invalid parameters
401	Unauthorized — invalid API key or session
404	Resource not found
422	Validation error
429	Rate limit exceeded
500	Internal server error

Rate Limits

API requests are rate-limited to ensure fair usage and platform stability.

Endpoint	Limit
POST /place-bet	10 requests per second
GET /session	60 requests per minute
GET /odds-feed	30 requests per minute

Ready to Integrate?

Get your API key and start building in minutes.

Get API Key Try Live Demo