# PlaySmart

## Docs

- [GET /v1/app-settings — Retrieve global app configuration](https://doc.playsmart.api.dolly.gg/api/app-settings.md): Retrieve the global PlaySmart application settings including maintenance mode, version requirements, ad frequency, and withdrawal configuration.
- [POST /auth/login — Log in and receive JWT tokens](https://doc.playsmart.api.dolly.gg/api/auth/login.md): Log in an existing PlaySmart player with email and password. Returns fresh JWT access and refresh tokens with the player's current profile.
- [POST /auth/register — Create a new player account](https://doc.playsmart.api.dolly.gg/api/auth/register.md): Register a new PlaySmart player with email, password, and device ID. Returns JWT access and refresh tokens along with the user profile object.
- [GET /v1/games — Fetch game catalog and configuration](https://doc.playsmart.api.dolly.gg/api/games.md): Fetch the list of active games and their configuration from PlaySmart. Supports filtering by bundle ID to retrieve a single game's settings.
- [POST /ingest/events — Submit a batch of gameplay events](https://doc.playsmart.api.dolly.gg/api/ingest-events.md): Send a batch of up to 200 gameplay events to PlaySmart. Requires authentication. Events are buffered and processed asynchronously within seconds.
- [POST /v1/withdrawals — Submit a PayPal withdrawal request](https://doc.playsmart.api.dolly.gg/api/withdrawals.md): Submit a withdrawal request for a player's USD balance via PayPal. Requires authentication. Immediately deducts the amount from the player's balance.
- [How PlaySmart authentication works: JWT bearer tokens](https://doc.playsmart.api.dolly.gg/authentication.md): PlaySmart uses JWT bearer tokens for API authentication. Register or log in to receive tokens, then pass them in the Authorization header.
- [PlaySmart coin economy: earning, converting, and withdrawing](https://doc.playsmart.api.dolly.gg/concepts/economy.md): Understand how PlaySmart's coin economy works: how players earn coins, how coins convert to USD, and how PayPal withdrawals are processed.
- [Gameplay analytics events: types, batching, and ingestion](https://doc.playsmart.api.dolly.gg/concepts/events.md): PlaySmart ingests gameplay events in batches. Learn available event types, how the batch payload works, and how events trigger automatic coin rewards.
- [Game catalog and app-level configuration in PlaySmart](https://doc.playsmart.api.dolly.gg/concepts/games.md): Learn how PlaySmart organizes games, what configuration fields control each game's behavior, and how app-level settings affect all players.
- [How players earn and accumulate coins in PlaySmart](https://doc.playsmart.api.dolly.gg/guides/earn-coins.md): Learn how PlaySmart awards coins to players automatically when they complete levels, and how to track coin balances through the user profile.
- [Register and authenticate players with the PlaySmart API](https://doc.playsmart.api.dolly.gg/guides/register-and-login.md): Step-by-step guide to creating player accounts and authenticating returning players using the PlaySmart API's register and login endpoints.
- [Track and send gameplay analytics events to PlaySmart](https://doc.playsmart.api.dolly.gg/guides/track-events.md): Learn how to send gameplay analytics events to PlaySmart in batches, including all supported event types and the customdata payload format.
- [Request and track PayPal cash withdrawals in PlaySmart](https://doc.playsmart.api.dolly.gg/guides/withdraw-earnings.md): Guide to requesting a PayPal cash withdrawal through the PlaySmart API, including balance requirements and withdrawal status tracking.
- [PlaySmart API overview: endpoints, auth, and responses](https://doc.playsmart.api.dolly.gg/introduction.md): PlaySmart's REST API manages player accounts, coin economies, real-money payouts, and analytics for mobile games. Learn the base URLs and response format.
- [PlaySmart quickstart: your first API call in minutes](https://doc.playsmart.api.dolly.gg/quickstart.md): Learn how to register a player, authenticate, and make your first PlaySmart API call in under five minutes with four simple steps.

## OpenAPI Specs

- [openapi](https://doc.playsmart.api.dolly.gg/api-reference/openapi.json)