# Game account

## Motivation

**coherence** provides an API for creating player game accounts that uniquely identify players across multiple devices. An account is required in order to use the rest of the online services, like the key-value store and matchmaking.

## Account Types

There are two types of accounts that are currently supported - guest accounts and user accounts.

### Guest Accounts

Guest accounts provide an easy way to start using the **coherence** online services without providing any user interface for user names or password. Everything is controlled with the [API](https://docs.coherence.io/0.8/api-reference/cloud-api/game-account), and is completely transparent to the player.

The session data for the account is stored locally on the device so it is important to know that uninstalling the game will also wipe out all the data and the account will be no longer accessible even if the player installs the game again.

### User Accounts

User accounts require explicit authorization by the player. Currently, only user name and password are supported as means for authentication. The user interface for entering the credentials must be provided by the game. Check the [API](https://docs.coherence.io/0.8/api-reference/cloud-api/game-account#user-account) how to use this feature.

In the future, there will be support for many more authentication mechanisms like Steam, Google Play Games, Sign in with Apple, etc.

## Using game accounts

Please refer to the [**Cloud API: Game Accounts**](https://docs.coherence.io/0.8/api-reference/cloud-api/game-account)**.**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coherence.io/0.8/game-services/game-account.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
