Features

Target outcomes

A target outcome tells the platform: on this player's n-th paid spin in this game, produce a round whose win is about X times the bet. Use it for test scenarios, promotions and QA.

• Available for games with target_outcomes: true in /games/health (974 of 1010 games).
• All methods are POST https://notell-api.com/gameActions.do with a method field. They need partner, api_key and an allowlisted IP.
• The optional Idempotency-Key header is supported by every method on this page (Conventions). Common errors (UNAUTHORIZED, IP_NOT_ALLOWED, INVALID_IDEMPOTENCY_KEY, IDEMPOTENCY_CONFLICT, RATE_LIMITED) are listed in Errors and not repeated in the tables below.
• The round is always the game's own natural outcome, found for this one entry: boards and features are never constructed by hand, and the result is not revealed in advance.
• Target outcomes apply to wallet sessions only, not to demo mode.

How an entry is applied#

Statuses:

Rules:

• The count starts when the entry becomes ready, not when it is scheduled. Only the player's paid spins in that game count; free-spin rounds do not.
• The spin_number-th counted spin pays multiplier × the spin's bet, with a tolerance of ±2 %. The multiplier does not depend on the bet size.
• When a spin does not fit the entry (for example an ante bet, a bonus buy for a spin entry, or no suitable round), the entry is postponed to the next paid spin.
• Several entries are allowed. Entries due on the same spin fire one per spin, oldest first.
• If the game asks the player to choose after the debit, the target applies to every option.
• Target-outcome rounds are marked and excluded from the player's adaptive RTP window (RTP). Their round_info notifications carry "forced": true (Wallet callbacks).
• Gamble after a target-outcome win is allowed in the games that offer it.

outcome_schedule#

Schedules a target outcome for a player in a game.

Request#

curl -s -X POST https://notell-api.com/gameActions.do \
  -H 'Content-Type: application/json' \
  -d '{
    "method": "outcome_schedule",
    "partner": "demo-casino",
    "api_key": "YOUR_API_KEY",
    "player_id": "player-1024",
    "symbol": "gates-of-olympus",
    "multiplier": "50",
    "kind": "bonus",
    "spin_number": 3,
    "external_id": "qa-case-17",
    "comment": "QA: big bonus on spin 3"
  }'

{
  "method": "outcome_schedule",
  "partner": "demo-casino",
  "api_key": "YOUR_API_KEY",
  "player_id": "player-1024",
  "symbol": "gates-of-olympus",
  "multiplier": "50",
  "kind": "bonus",
  "spin_number": 3,
  "external_id": "qa-case-17",
  "comment": "QA: big bonus on spin 3"
}

Response#

{
  "status": "ok",
  "outcome": {
    "outcome_id": "5a3e91d2-7c4b-4e08-b6a1-3f9d2c8e1a70",
    "external_id": "qa-case-17",
    "player_id": "player-1024",
    "symbol": "gates-of-olympus",
    "provider": "pragmatic",
    "kind": "bonus",
    "multiplier": "50.00",
    "spin_number": 3,
    "paid_spins_since": 0,
    "status": "pending",
    "variants": [],
    "comment": "QA: big bonus on spin 3",
    "created_at": "2027-02-15T10:00:00.000Z",
    "expires_at": "2027-02-28T12:00:00.000Z",
    "applied_at": null,
    "round_id": null
  }
}

Errors#

outcome_get#

Returns one entry by outcome_id or by your external_id.

Request#

curl -s -X POST https://notell-api.com/gameActions.do \
  -H 'Content-Type: application/json' \
  -d '{"method":"outcome_get","partner":"demo-casino","api_key":"YOUR_API_KEY","external_id":"qa-case-17"}'

{
  "method": "outcome_get",
  "partner": "demo-casino",
  "api_key": "YOUR_API_KEY",
  "external_id": "qa-case-17"
}

Response#

{
  "status": "ok",
  "outcome": {
    "outcome_id": "5a3e91d2-7c4b-4e08-b6a1-3f9d2c8e1a70",
    "external_id": "qa-case-17",
    "player_id": "player-1024",
    "symbol": "gates-of-olympus",
    "provider": "pragmatic",
    "kind": "bonus",
    "multiplier": "50.00",
    "spin_number": 3,
    "paid_spins_since": 1,
    "status": "ready",
    "variants": ["bonus"],
    "comment": "QA: big bonus on spin 3",
    "created_at": "2027-02-15T10:00:00.000Z",
    "expires_at": "2027-02-28T12:00:00.000Z",
    "applied_at": null,
    "round_id": null
  }
}

The outcome object is described under outcome_schedule.

Errors#

outcome_list#

Lists entries of your project, newest first, at most 200.

Request#

curl -s -X POST https://notell-api.com/gameActions.do \
  -H 'Content-Type: application/json' \
  -d '{"method":"outcome_list","partner":"demo-casino","api_key":"YOUR_API_KEY","player_id":"player-1024","status":"ready"}'

{
  "method": "outcome_list",
  "partner": "demo-casino",
  "api_key": "YOUR_API_KEY",
  "player_id": "player-1024",
  "status": "ready"
}

Response#

{
  "status": "ok",
  "outcomes": [
    {
      "outcome_id": "5a3e91d2-7c4b-4e08-b6a1-3f9d2c8e1a70",
      "external_id": "qa-case-17",
      "player_id": "player-1024",
      "symbol": "gates-of-olympus",
      "provider": "pragmatic",
      "kind": "bonus",
      "multiplier": "50.00",
      "spin_number": 3,
      "paid_spins_since": 1,
      "status": "ready",
      "variants": ["bonus"],
      "comment": "QA: big bonus on spin 3",
      "created_at": "2027-02-15T10:00:00.000Z",
      "expires_at": "2027-02-28T12:00:00.000Z",
      "applied_at": null,
      "round_id": null
    }
  ]
}

Errors#

outcome_cancel#

Cancels an entry that is pending, ready or unreachable. For any other status the entry is returned unchanged.

Request#

curl -s -X POST https://notell-api.com/gameActions.do \
  -H 'Content-Type: application/json' \
  -d '{"method":"outcome_cancel","partner":"demo-casino","api_key":"YOUR_API_KEY","outcome_id":"5a3e91d2-7c4b-4e08-b6a1-3f9d2c8e1a70"}'

{
  "method": "outcome_cancel",
  "partner": "demo-casino",
  "api_key": "YOUR_API_KEY",
  "outcome_id": "5a3e91d2-7c4b-4e08-b6a1-3f9d2c8e1a70"
}

Response#

{
  "status": "ok",
  "outcome": {
    "outcome_id": "5a3e91d2-7c4b-4e08-b6a1-3f9d2c8e1a70",
    "external_id": "qa-case-17",
    "player_id": "player-1024",
    "symbol": "gates-of-olympus",
    "provider": "pragmatic",
    "kind": "bonus",
    "multiplier": "50.00",
    "spin_number": 3,
    "paid_spins_since": 1,
    "status": "cancelled",
    "variants": ["bonus"],
    "comment": "QA: big bonus on spin 3",
    "created_at": "2027-02-15T10:00:00.000Z",
    "expires_at": "2027-02-28T12:00:00.000Z",
    "applied_at": null,
    "round_id": null
  }
}

Errors#

See also#

• RTP: why these rounds are excluded from the adaptive window.
• Wallet callbacks: the forced flag of round_info.
• Admin: the same entries can be managed in the admin panel.