Player API

Full player & host action API

Invoke any of ~70 player/host actions by name. Reads need scope read, writes write, tax actions tax, host actions host. Examples: list_trips, get_trip, tier_status, bankroll_status, list_w2g, tax_year_summary, freeplay_optimizer, card_recommendation, tier_retention_plan, list_share_links, list_notifications, add_trip, upsert_tier, bankroll_add, create_share_link, manual_w2g, host_dashboard. Admin + key-management actions are rejected (403). For write actions, an Idempotency-Key header is accepted (idempotent replay is planned, not yet enforced).

post/v1/player

Request

  • Base URL: https://nbhagdwegk.execute-api.us-east-1.amazonaws.com
  • URL: https://nbhagdwegk.execute-api.us-east-1.amazonaws.com/v1/player
  • Auth: HTTP bearer

Headers

Idempotency-Keystring uuid

Optional UUID on write requests. Accepted for forward compatibility; idempotent replay is planned but not yet enforced.

Request body

action'list_trips' | 'trips_trend' | 'get_trip' | 'list_offers' | 'list_casinos' | 'list_all_casinos' | 'tier_status' | 'list_visits' | 'list_vouchers' | 'bankroll_status' | 'bankroll_trend' | 'plan_trip' | 'trip_planner_estimate' | 'freeplay_optimizer' | 'card_recommendation' | 'tier_retention_plan' | 'list_rewards_programs' | 'list_credit_packages' | 'list_host_reviews' | 'list_share_links' | 'list_consent' | 'slot_leaderboard' | 'list_tier_listings' | 'list_group_trips' | 'list_messages' | 'list_notifications' | 'get_notification_preferences' | 'get_leaderboard_opt_in' | 'get_marketplace_optin' | 'list_support_tickets' | 'list_machines' | 'onboarding_status' | 'get_host_application' | 'add_trip' | 'add_session' | 'start_visit' | 'end_visit' | 'redeem_voucher' | 'bankroll_add' | 'mark_offer_status' | 'add_offer' | 'delete_offer' | 'upsert_tier' | 'delete_tier' | 'create_share_link' | 'revoke_share_link' | 'set_consent_channel' | 'create_tier_listing' | 'claim_tier_listing' | 'create_group_trip' | 'invite_to_group_trip' | 'mark_message_read' | 'mark_notification_read' | 'mark_lead_contacted' | 'set_notification_preferences' | 'set_leaderboard_opt_in' | 'create_support_ticket' | 'upsert_machine' | 'log_machine_play' | 'apply_host' | 'submit_host_review' | 'list_w2g' | 'manual_w2g' | 'create_w2g_scan_session' | 'tax_year_summary' | 'tax_year_export' | 'list_hand_pays' | 'add_hand_pay' | 'list_losses' | 'add_loss' | 'host_dashboard' | 'host_my_leads' | 'host_credits_log' | 'host_roi' required

Player/host action name. read/write need scope read/write; tax actions need tax; host actions need host. (The lead-marketplace actions are omitted pending legal review.)

Example request

{
  "action": "tax_year_summary"
}

Response

Action result (shape depends on the action; always { data: { success, ... } }).

object required

Changes

No recorded changes to this operation across all 1 revision of this API.