API Documentation

Base URL

https://api.tagbet.net/api

Authentication

x-api-key header

Format

JSON (REST)

Quick Start

1
Contact us to create a client account
Email: integration@tagbet.net
2
Receive your API keys from the AGIXX team
Format: pk_live_xxxxxxxxxxxxxxxxxxxxxxxx (production) or pk_test_xxxxxxxx (testing)
3
Set up the callback endpoint on your server and send us its URL
The AGIXX team configures your callbackUrl. We will POST wallet events (bet / win / betwin / rollback) to it
4
Send a POST request to /api/v1/launch to get a game URL
Redirect your player to the returned gameUrl

Authentication

Include your API key in every request header. Keep it secret — never expose it in client-side code.

Use pk_live_... keys for production and pk_test_... keys for testing.

HTTP

x-api-key: pk_live_your_api_key_here

Error Codes

400	Bad Request	Missing or invalid parameters
401	Unauthorized	Missing or invalid API key
403	Forbidden	Provider not enabled for your account
404	Not Found	Game or session not found
429	Rate Limited	Too many requests — limit is 200 req / 60 s
500	Server Error	Internal error — contact support

Error Response Format

statusCode and message are always present; error (the HTTP reason phrase) is present on most 4xx responses but not on 429 / 500. message is a string, or an array of strings for request-body validation errors. Most launch errors also include a canonical object — switch on canonical.errorCode when present (unknown provider (404) and provider not enabled / game blocked (403) arrive without it; see Schema Reference):

JSON

// 400 from POST /api/v1/launch
{
  "statusCode": 400,
  "message":    "gameId must be a numeric string",
  "error":      "Bad Request",
  "canonical": {
    "errorCode": "INVALID_REQUEST",
    "message":   "gameId must be a numeric string",
    "provider":  "PRAGMATIC_PLAY"
  }
}

// 401 — missing / invalid API key (may arrive without a canonical object)
{
  "statusCode": 401,
  "message":    "API key required",
  "error":      "Unauthorized"
}

Supported Currencies

TRY

Turkish Lira

ILS

Israeli Shekel

EUR

Euro

USD

US Dollar

Ready to integrate?

AGIXX API

Quick Start

Authentication

Error Codes

Error Response Format

Supported Currencies