# Auth
## Forgot Password
Use this end point to request verification code when the user forgets the password
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/forgot-password" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"email":"reiciendis"}'
```
> Example response (200):
```json
{
"message": "You will receive a verification code on your registered email. This code will be valid for 24 hours."
}
```
> Example response (404):
```json
{
"message": "User not found!"
}
```
> Example response (422):
```json
{
"message": "Validation Failed!",
"errors": {
"email": [
"The email field is required."
]
}
}
```
Request failed with error:
## Reset Password
Use this end point to reset the password
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/reset-password" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"user_id":19,"otp":"non","password":"id","password_confirmation":"ea"}'
```
> Example response (200):
```json
{
"message": "Your password has been changed!"
}
```
> Example response (404):
```json
{
"message": "User not found!"
}
```
> Example response (422):
```json
{
"message": "Validation Failed!",
"errors": {
"user_id": [
"The user id field is required."
],
"otp": [
"The otp field is required."
],
"password": [
"The password field is required."
]
}
}
```
Request failed with error:
## Verify Code
Use this end point to verify the code (OTP)
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/verify-code" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"otp":"recusandae","email":"accusamus","type":"quisquam"}'
```
> Example response (200):
```json
{
"message": "Verification successfull!",
"data": {
"otp": "2633",
"type": "10",
"user": {
"id": 2,
"email": "taha@elegantmicroweb.com",
"username": "tahasethwala"
}
}
}
```
> Example response (404):
```json
{
"message": "Email is not registered"
}
```
> Example response (422):
```json
{
"message": "Validation Failed!",
"errors": {
"otp ": [
"The otp field is required."
],
"type": [
"The type field is required."
]
}
}
```
Request failed with error:
## Reactivate Account Send OTP
Use this end point to send otp to reactivate deleted account
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/reactivate-account-send-otp" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"phone":"voluptatem","otp_signature":"FtSl93sVi2G"}'
```
> Example response (201):
```json
{
"message": "OTP Sent Successfully"
}
```
> Example response (422):
```json
{
"message": "Validation Failed!",
"errors": {
"phone ": [
"The phone field is required."
]
}
}
```
Request failed with error:
## Send Verification Mail
requires authentication
Use this end point to send a mail to user to verify email.
> Example request:
```bash
curl -X GET \
-G "https://apiqa.bettorfantasy.com/user/send-verification-mail" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"email":"aut"}'
```
> Example response (200):
```json
{
"message": "Verification mail sent successfully!"
}
```
> Example response (422):
```json
{
"message": "Please enter required information",
"errors": {
"email": [
"The email field is required."
],
}
}
```
Request failed with error:
## Get Current Versions Of App
requires authentication
Use this end point to get current versions of app
> Example request:
```bash
curl -X GET \
-G "https://apiqa.bettorfantasy.com/check-app-update" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
```
> Example response (200):
```json
{
"message": "Current Versions",
"data": {
"android_version": "90",
"android_force_update": "1",
"ios_version": "19.0",
"ios_force_update": "1"
}
}
```
Request failed with error:
## Check Maintenance Mode for App
requires authentication
Use this end point to check maintenance mode for app
> Example request:
```bash
curl -X GET \
-G "https://apiqa.bettorfantasy.com/check-maintenance-mode" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
```
> Example response (200):
```json
* "maintenance_mode": "disabled"
}
```
Request failed with error:
## Update FCM token
requires authentication
Use this end point to update FCM token
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/update-fcm-token" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fcm_token":"aliquam"}'
```
> Example response (200):
```json
{
"message": "FCM token updated successfully!"
}
```
> Example response (422):
```json
{
"message": "Please enter required information",
"errors": {
"fcm_token": [
"The fcm token is required"
]
}
}
```
Request failed with error:
## Balance
requires authentication
Use this end point to get balance
> Example request:
```bash
curl -X GET \
-G "https://apiqa.bettorfantasy.com/balance" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
```
> Example response (200):
```json
{
"message": "My Balance!",
"data": {
"available_bucks": "0",
"available_credits": "950",
"available_cash": "0",
"reward_earned_credits": "0",
"challenges_won": [],
"flag_feature_bettorlive": 1,
"kyc_status": {
"id": 1,
"name": "Not performed",
"created_at": "2022-05-16T06:02:06.000000Z",
"updated_at": "2022-05-16T06:02:06.000000Z"
},
"geo_location_status": {
"id": 4,
"name": "DENIED",
"created_at": "2022-05-17T07:31:13.000000Z",
"updated_at": "2022-05-17T07:31:13.000000Z"
},
"is_dfs_geolocation_step_passed": 0,
"cash_deposit_min": "10",
"cash_deposit_max": "5000",
"cash_transaction": null,
"xpoint_client_key": "bettorfantasy15423dev",
"games": [
{
"id": 4,
"name": "Ice Hockey (NHL)",
"image": "http:\/\/127.0.0.1:8000\/images\/icon-icehockey.png",
"status": "Active",
"sequence": 0,
"created_at": null,
"updated_at": null
},
{
"id": 3,
"name": "Baseball (MLB)",
"image": "http:\/\/127.0.0.1:8000\/images\/icon-baseball.png",
"status": "Active",
"sequence": 1,
"created_at": null,
"updated_at": "2022-07-15T06:53:42.000000Z"
},
{
"id": 2,
"name": "Basketball (NBA)",
"image": "http:\/\/127.0.0.1:8000\/images\/icon-basketball.png",
"status": "Paused",
"sequence": 2,
"created_at": null,
"updated_at": "2022-07-15T06:53:59.000000Z"
}
],
"kyc_dob": null,
"websocket_host": null,
"websocket_port": "6001",
"websocket_key": "34864a25-3910-408d-8527-7f8aea0f9ccf",
"privacy_show_recent_picks": 1,
"navigations": [
{
"id": 1,
"name": "Fantasy",
"status": "Active",
"sequence": 1
},
{
"id": 2,
"name": "Props",
"status": "Active",
"sequence": 2
},
{
"id": 3,
"name": "Survival",
"status": "Active",
"sequence": 3
},
{
"id": 4,
"name": "Pools",
"status": "Active",
"sequence": 4
}
]
}
}
```
Request failed with error:
## Balance V2
requires authentication
Use this end point to get balance
> Example request:
```bash
curl -X GET \
-G "https://apiqa.bettorfantasy.com/balance/v2" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
```
> Example response (200):
```json
{
{
"message": "My Balance!",
"data": {
"username": "uemswati150920251",
"available_bucks": "0",
"available_credits": "6960",
"available_cash": "0",
"available_cash_excluding_site_credits": "0",
"available_site_credits": "0",
"reward_earned_credits": "0",
"kyc_status": {
"id": 1,
"name": "Not performed"
},
"kyc_upload_url": null,
"kyc_url_days_passed": null,
"kyc_url_expiry": 14,
"geo_location_status": {
"id": 3,
"name": "ALLOWED"
},
"cash_deposit_min": "10",
"cash_deposit_max": "5000",
"xpoint_client_key": "bettorfantasy15423dev",
"games": [
{
"id": 1,
"name": "NFL",
"image": "http://127.0.0.1:8000/images/icon-football-v2.png",
"status": "Active",
"sequence": 0,
"created_at": null,
"updated_at": "2025-02-27T12:13:56.000000Z",
"featured_contest_image": "nfl_feature_contest.png",
"featured_contest_color1": "0xFF003EFF",
"featured_contest_color2": "0xFF001864",
"featured_contest_btn_color": "0xFF012084",
"featured_contest_color3": "0xFF0F2BB0",
"big_wins_color1": "0xFF1A44C8",
"big_wins_color2": "0xFF1A3482",
"big_wins_image": "nfl_big_wins.png",
"big_wins_arrow": "nfl_arrows.png",
"big_wins_text_color": "0xFFD1D8EE",
"cron_status": 1
}
],
"kyc_dob": null,
"privacy_show_recent_picks": 1,
"is_appsflyer_withdrawal_done_recently": 0,
"is_appsflyer_deposit": 0,
"is_appsflyer_first_deposit": 0,
"is_appsflyer_second_deposit": 0,
"is_appsflyer_first_time_cash_entry": 0,
"experience_level": "Beginner",
"is_self_exclusion": 0,
"trivia_reset_seconds": "20h 29m",
"is_trivia_done": 0,
"is_scoring_notice_dsa": 1,
"reward_value": 20,
"deposit_checkout_url": "http://127.0.0.1:8000/v2/payments/deposit/checkout?user_id=854&token=uK0ANI4bEXnf5tgD",
"payment_methods_count": 3,
"payment_methods": [
{
"id": 9,
"userPaymentOptionId": "135394628",
"payment_method": "apmgw_eCheckSelect",
"cardType": null,
"method_image": "http://127.0.0.1:8000/images/payments/ibt-white.png",
"method_name": "Online Banking",
"method_masked_number": "Online Banking ****6196",
"method_masked_number_new": "Online Banking ****6196",
"is_default": 0,
"expMonth": "--",
"expYear": "--",
"lastFourDigits": "--",
"firstName": "Taha",
"lastName": "EM",
"address": "Address 1",
"phone": "+11234567890",
"zip": "12344",
"city": "Abad",
"country": "US",
"state": "KY",
"email": "accountholder0@example.com",
"created_at": "2024-12-12T11:18:39.000000Z"
}
],
"deposit_validations": {
"minimum_deposit_limit": "25",
"daily_deposit_limit": "250",
"week_deposit_limit": "500",
"month_deposit_limit": "1000",
"today_deposit": "0",
"week_deposit": "0",
"month_deposit": "0"
},
"referral_code_appsflyer": "https://fantasyspin1.onelink.me/kjUP/uemswati150920251",
"is_email_verified_new": 1,
"kyc_attempts": null,
"fcm_token": null,
"enjoying_fs_status": "not_eligible",
"maintenance_mode": "disabled",
"is_gameplay_sound_enabled": 1,
"next_sound_key": "fantasyspin_classic",
"user_background_sounds": [
{
"sound_key": "fantasyspin_classic",
"is_enabled": 1
}
],
"current_streak": 0,
"version_info": {
"android_version": "73.0",
"android_force_update": "1",
"android_release_notes": [
{
"title": "🚀 Featured Contests",
"description": "View and easily enter the top contests that are available on FantasySpin"
},
{
"title": "🚀 Referral Tier Bonuses",
"description": "Refer friends, earn more with tiered rewards--up to $700 for 20 referrals!"
}
],
"ios_version": "19.0",
"ios_force_update": "1",
"ios_release_notes": [
{
"title": "🚀 Featured Contests",
"description": "View and easily enter the top contests that are available on FantasySpin"
},
{
"title": "🚀 Referral Tier Bonuses",
"description": "Refer friends, earn more with tiered rewards--up to $700 for 20 referrals!"
}
]
}
}
}
}
```
Request failed with error:
## Save Referral Link
requires authentication
Called by the mobile app after generating a referral link via the AppsFlyer SDK.
Saves the link to the user record and logs the call.
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/save-referral-link" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"referral_link":"https:\/\/fantasyspin1.onelink.me\/kjUP\/abc123"}'
```
> Example response (200):
```json
{
"message": "Referral link saved successfully!"
}
```
> Example response (422):
```json
{
"message": "Please enter required information",
"errors": {
"referral_link": [
"The referral link field is required."
]
}
}
```
Request failed with error:
## Device Info Logs
requires authentication
Use this end point to capture device info logs.
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/device-info-logs" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"platform":"officia","os":"nostrum","version":"dolores","brand":"corrupti","model":"impedit"}'
```
> Example response (200):
```json
{
"message": "Log saved successfully!"
}
```
> Example response (422):
```json
{
"message": "Please enter required information",
"errors": {
"platform": [
"The platform field is required."
],
"os": [
"The os field is required."
],
"version": [
"The version field is required."
]
}
}
```
Request failed with error:
## Sign Out
requires authentication
Use this end point to sign out.
> Example request:
```bash
curl -X GET \
-G "https://apiqa.bettorfantasy.com/sign-out" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
```
> Example response (200):
```json
{
"message": "Sign out successfull!"
}
```
Request failed with error:
## Delete Account
requires authentication
Use this end point to delete account
> Example request:
```bash
curl -X GET \
-G "https://apiqa.bettorfantasy.com/delete-account" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
```
> Example response (200):
```json
{
"message": "Account deleted successfully!"
}
```
> Example response (422, Unable To Delete Account):
```json
{
"message": "Validations",
"error_box": {
"heading": "Unable To Delete Account",
"message": "We are unable to delete your account because you are currently entered into active cash contests and/or have funds in your account.",
"cta": "Return",
"color": "Blue",
"cta_type": "Return",
}
}
```
Request failed with error:
## Update In-App Rating Flag
requires authentication
Use this endpoint to mark that the user has closed the in-app rating popup.
> Example request:
```bash
curl -X GET \
-G "https://apiqa.bettorfantasy.com/update/in-app-rating-flag" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
```
> Example response (200):
```json
{
"message": "App rating flag updated successfully!"
}
```
> Example response (404):
```json
{
"message": "User not found"
}
```
Request failed with error:
## Update User Mode
requires authentication
Use this endpoint to update the user app mode.
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/update/user-mode" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"user_mode":"Arcade."}'
```
> Example response (200):
```json
{
"message": "User mode updated successfully!"
}
```
> Example response (404):
```json
{
"message": "User not found"
}
```
> Example response (422):
```json
{
"message": "Please enter required information",
"errors": {
"user_mode": [
"The user_mode field is required."
],
}
}
```
Request failed with error:
## Store Promo Code
requires authentication
Use this endpoint to store promo code after registration
> Example request:
```bash
curl -X POST \
"https://apiqa.bettorfantasy.com/updated/promo-code" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"promo_code":"molestias"}'
```
> Example response (201):
```json
{
"message": "Promo code updated successfully",
"data": {
"user": {
"id": 670,
"email": "uemankita2905202517@yopmail.com",
"username": "uemankita2905202517",
"is_adult": 1,
"phone": "5424349875",
"avatar": "http:\/\/127.0.0.1:8000\/images\/avatar-default.png",
"is_email_verified": 1,
"email_verified_date_time": "2025-05-29 05:01:01",
"created_at": "2025-05-29T03:31:01.000000Z",
"updated_at": "2026-01-30T06:22:22.000000Z",
"promo_code": "SPINTOWIN",
"bucks": 0,
"credits": -4,
"available_cash": 10,
"referral_code": "e6f657fb-0072-4b4c-8dcc-d23fd9202afc",
"unique_onboarding_id": "fd4eb1a3-f3d2-4ed2-bc09-de3b684d79a3",
"timezone": "Asia\/Kolkata",
"platform": "Android"
}
}
}
```
> Example response (401):
```json
{
"message": "User not found!"
}
```
Request failed with error:
## Check User Eligibility of Practice Draft
requires authentication
Use this endpoint to check if user is eligible to see practice draft popup
> Example request:
```bash
curl -X GET \
-G "https://apiqa.bettorfantasy.com/check/user/practice-draft-eligible" \
-H "Authorization: Bearer {YOUR_AUTH_KEY}" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
```
> Example response (201):
```json
{
"message": "User eligibility fetched successfully",
"data": {
'is_practice_draft_popup_eligible' => 1,
'fantasy_spin_contest_id' => 23
}
}
```
> Example response (401):
```json
{
"message": "User not found!"
}
```
Request failed with error:
## Check Sport-Wise Practice Draft Eligibility
requires authentication
Returns all active games with their icons and color codes, each indicating
whether a practice draft contest is currently available for that sport.
> Example request:
```bash
curl -X GET \
-G "https://apiqa.bettorfantasy.com/check/sport/practice-draft-eligible" \
-H "Authorization: required Bearer token. Example: Bearer {YOUR_AUTH_TOKEN}" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
```
> Example response (200):
```json
{
"message": "Sport-wise practice draft eligibility fetched successfully",
"data": [
{
"id": 1,
"name": "NFL",
"image": "https:\/\/example.com\/images\/icon-football.png",
"featured_contest_color1": "#0A1931",
"featured_contest_color2": "#1B5E20",
"featured_contest_color3": "#2E7D32",
"featured_contest_btn_color": "#4CAF50",
"is_practice_draft_available": 1,
"fantasy_spin_contest_id": 42
},
{
"id": 2,
"name": "NBA",
"image": "https:\/\/example.com\/images\/icon-basketball.png",
"featured_contest_color1": "#0A1931",
"featured_contest_color2": "#1A237E",
"featured_contest_color3": "#283593",
"featured_contest_btn_color": "#3949AB",
"is_practice_draft_available": 0,
"fantasy_spin_contest_id": null
}
]
}
```
> Example response (401):
```json
{
"message": "User not found!"
}
```
Request failed with error: