⚡ Partner API — v1

RIM PRO Developer Hub

Integrate the RIM roulette analytics engine directly into your application. Real-time spin processing, combination tracking, and balance management — all via a simple REST API.

Get API Access → Quick Start

Overview

The RIM PRO Partner API is a RESTful HTTP API that exposes the core roulette analytics engine to authenticated partner applications.

Base URL
/partner/api
Format
application/json
Auth
Bearer API Key

Authentication

All endpoints (except /partner/api/token) require a Bearer API key in the HTTP header.

Request Header 
Authorization: Bearer rim_your_api_key_here
⚠ Security: Never expose your API key in client-side JavaScript or public repositories. Store it in environment variables or a secret manager.

Quick Start

Get up and running in under 5 minutes with cURL or any HTTP client.

  1. 1 Purchase a Partner plan from the Pricing page
  2. 2 Get your API key from Account → API Access
  3. 3 Make your first API call:
    cURL 
    curl -H "Authorization: Bearer rim_YOUR_KEY" \
  https://yourdomain.com/partner/api/state
POST /partner/api/token Public

Exchange your email and password for an API key. This is the only endpoint that does not require a Bearer header.

Request Body

JSON 
{
  "email": "you@example.com",
  "password": "your_password"
}

Response 200

{
  "api_key": "rim_a3f2b9c8d6e1...",
  "api_key_created_at": "2026-03-01T10:00:00+00:00",
  "subscription_active": true,
  "role": "ROLE_PARTNER"
}
GET /partner/api/state Auth Required

Retrieve the current spin state for your account — spin count, last numbers drawn, active combinations, and current balance.

Response 200

{
  "spin": 42,
  "list": [14, 7, 22, 0],
  "first": 22,
  "second": 23,
  "third": 24,
  "combinations": [...],
  "win": 150.0,
  "set_balance": 150.0,
  "bets": [1, 2, 3],
  "prediction": ""
}
FieldTypeDescription
spinintegerNumber of spins recorded in the current set
listarrayOrdered list of roulette numbers (most recent last)
first/second/thirdinteger|nullPredicted group of 3 numbers to watch
combinationsarrayActive prediction combinations
winfloatOverall account balance
set_balancefloatBalance for the current session set only
predictionstringNew combination prediction description, if any
POST /partner/api/spin Auth Required

Submit a roulette spin result (0–36). The engine evaluates combinations, updates balances, and returns the new state.

Request Body

JSON 
{
  "number": 14
}

cURL Example

Shell 
curl -X POST \
  -H "Authorization: Bearer rim_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number":14}' \
  .../partner/api/spin
Valid values: number must be an integer from 0 to 36.
The response structure is identical to GET /state.
POST /partner/api/restart Auth Required

Start a fresh session set. All active combinations are deactivated and a new set is created. No request body needed.

Response 200

{
  "id": 42,
  "spin": 0,
  "win": 0.0,
  "set_balance": 0.0,
  "list": [],
  "combinations": [],
  "first": null, "second": null, "third": null
}
GET /partner/api/account Auth Required

Returns your profile, subscription status, and masked API key metadata.

{
  "id": 5,
  "email": "dev@example.com",
  "first_name": "Jane",
  "last_name": "Doe",
  "roles": ["ROLE_PARTNER", "ROLE_USER"],
  "subscription_active": true,
  "subscribed_until": "2027-01-01T00:00:00+00:00",
  "balance": 150.0,
  "api_key_prefix": "rim_a3f2b9c8••••",
  "api_key_created_at": "2026-03-01T10:00:00+00:00"
}
POST /partner/api/key/regenerate Auth Required

Generate a new API key. Your old key is immediately invalidated. No request body required.

{
  "api_key": "rim_new_key_here...",
  "api_key_created_at": "2026-03-03T14:00:00+00:00",
  "message": "API key regenerated. Your old key is now invalid."
}

Error Codes

Status Code Meaning
200OKRequest succeeded
400Bad RequestMissing or invalid field (e.g. number out of 0–36 range)
401UnauthorizedMissing or invalid API key
402Payment RequiredAccount subscription is expired or inactive
403ForbiddenAccount does not have ROLE_PARTNER
500Server ErrorUnexpected server error — contact support
Error Response Shape
{
  "error": "Unauthorized",
  "message": "Invalid API key."
}

Partner Onboarding Flow

  1. 1

    Register

    Create a free account at /register.

  2. 2

    Purchase Partner Plan

    Select a plan that includes API access on the Pricing page and complete payment.

  3. 3

    Get Your API Key

    Visit Account → API Access after your subscription activates. Click "Generate API Key".

  4. 4

    Integrate

    Add the Authorization: Bearer header to your server-side HTTP requests.

  5. 5

    Go Live

    Start processing spins in real-time from your own application.

Ready to integrate?

View Partner Plans →