1. Promo API
BETCORE Promo API
  • General documentation
    • What's new?
    • Dictionaries
    • Signing of server requests
    • Error codes
  • Promo API
    • /FreeBets/Campaign/Create
      POST
    • /FreeBets/Issue
      POST
    • /FreeBets/Cancel
      POST
  • BETCORE API
    • /Game/List
      POST
  1. Promo API

/FreeBets/Issue

POST
/FreeBets/Issue
That method is used to issue a freebet bonus to the player.
Freebets can be issued either by using a campaign (campaign_id) or directly without a campaign:
  • if campaign_id is provided, freebet configuration (games, bet amounts, validity, coefficients) is taken from the campaign
  • if campaign_id is not provided, all freebet parameters must be specified in the request.
Freebet issue requests are idempotent: requests with the same issue_id must not be processed twice and should return the original response.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

🟠4XXClient Error
🔴5XXServer Error
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://backend.bcdprod.net/partnersmediator-service/api/v3/FreeBets/Issue' \
--header 'X-REQUEST-SIGN: XXX' \
--header 'Content-Type: application/json' \
--data '{
    "issue_id": "648056e4-5064-40bd-9c34-8ab31c628a91",
    "campaign_id": "summer_fb_2026",
    "account_id": "8821415121",
    "is_test": false,
    "client_id": 6781234521,
    "quantity": 1,
    "currency": "EUR"
}'
Response Response Example
200 - Success
{
    "bonus_id": "648056e4-5064-40bd-9c34-8ab31c628a91"
}
Modified at 2026-10-01 08:41:30
Previous
/FreeBets/Campaign/Create
Next
/FreeBets/Cancel
Built with